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With to get you started on custom maker 
projects, the WD PiDrive Foundation Edition has everything you 
need to to start learning how to make creations of your own. 


HASSLE-FREE EASY SWITCH BETWEEN 
OS INSTALLER OFFLINE SETUP PROJECTS ON THE FLY 
With a custom version of the NOOBS The included SD card comes with Raspbian With the ability to partition the 
(New Out of Box Software), included on PIXEL and Raspbian Lite pre-installed, giving WD PiDrive Foundation Edition into 
your microSD, you can download your you two starter operating systems from the Project Spaces, you can create a custom 
Raspbian operating system of choice Raspberry Pi Foundation to experiment with. storage solution to fit multiple projects 
in a matter of moments. on the same Pi and drive arrangement. 
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WELCOME TO 
THE OFFICIAL omais 


: f The @ & 
e’re still riding high on the success Set | \e Sg 
of last month’s 50th issue, in which — A 

REMOTE 


we counted down the best Raspberry CONTROL 
Pi projects ever made. The response from our sete EY faa 
readers to the public-voted portion of our 
countdown ~- the all-important top 20 ~- was 
astounding, so please accept our heartfelt 
thanks for making it such a memorable 
community event! 
We’re back to business as usual this issue. 

Just the standard, everyday, run-of-the-mill 
articles you’ve come to expect from the 


magazine on a month-by-month basis. THIS MONTH: 
Standard stuff like shootin r code 


SUBSCRIBE & 


SEE PAGE 30 FOR DETAILS 
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g you 

into space, building awesome robots, 

mastering essential computing expertise, 06 BLAST YOUR CODE INTO SPACE 
and bootstrapping the impossible with Enter the new, improved Europe-wide Astro Pi competition 


nothing more than affordable technology, 
a free weekend, and the skills to succeed. 
Just the usual. 


14 BUILD YOUR OWN ROBOT 


Ladies and gentleman, we can build it. We have the technology 


44 CONFIGURE YOUR RASPBERRY PI 


Tweak your Pi's dials in another essential beginner's guide 


Enjoy the issue! 
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TUTORIALS 


> RASPBERRY PI 101 - NOOBS 
Install one of many OSes with NOOBS 


> RASPBERRY PI 101 - CONFIG 


Change the way your Raspberry Pi works 


> HOW TO USE SCRATCH 2.0 


Upgrade Raspbian with PIXEL to use Scratch 2.0 


> UNDERWATER CAMERA 


Build a waterproof, Pi-powered camera 


> INTRO TO C PART 5 


How to use pointers in your code 


> BUILD A WIFI DETECTOR 


Find out who's been at your house by using WiFi 


> CREATE A STATUES GAME 


Play statues with a Raspberry Pi in the Pi Bakery 


> ARCADE MACHINE PART 5 


Finish building the RaspCade 


> MAKE PONG WITH PI CAP 


How to make Capong, a physical version of Pong 


> PIVR — PVR ON YOUR PI 


Upgrade your Pi media centre with a PVR 
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Astro Pi is back with a Europe-wide 
challenge for kids to enter! 
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Element14's community challenge 
is over, with some amazing results 
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ESA astronaut Thomas Pesquet is challenging 
school students across Europe (credit: ESA/NASA) 


Students and teachers should first assemble 
a mission team, which must include at least 
one support teacher as well as students under 


the age of 16. Use the Mission Plan Template 
(magpi.cc/2enYSWP) to design a sample mission 
that showcases your approach to running a space 
mission, and demonstrates that you can break 
down your big idea into concrete steps. 

The deadline for the first round of applications 
is 13 November 2016. 


Teams from France should register in French 
through the Centre National d'Études Spatiales: 
magpi.cc/2e012zYh. 


Teams from Poland should register in Polish 
through ESERO Poland: magpi.cc/2dUyJya. 


Teams from the other ESA Member States 
should register and upload their mission plan 
(in English) with ESA: magpi.cc/2e03Fre. 


If you're Looking for inspiration, take a look at 
the winners from Tim Peake’s Astro Pi mission 
(magpi.cc/2e0258N). 
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BLASTS 
BACK INTO SPACE 


Brand-new European mission for Astro Pi units sees students 
across Europe developing code for Ed and Izzy 


he European Space Agency 
(ESA) and the Raspberry 
Pi Foundation have 
teamed up to run a brand-new 
Astro Pi challenge. 

Space cadets will get another 
chance to create code for Ed and 
Izzy, the two Astro Pi units on 
board the International Space 
Station (ISS). For this mission, 
students from France, Spain, 
Germany, and other European 
countries will join young coders 
from Britain. 

This time around, ESA French 
astronaut Thomas Pesquet will run 
code on Ed and Izzy. 

Thomas is ready to blast into 
space in November 2016. He will 
serve on board the ISS as a flight 
engineer for Expeditions 50 and 51. 

“Tm currently at the European 
Astronaut centre,” he told us. 
“Pm training for my Proxima 
mission. Pll be going to the 
International Space Station 
this autumn, for six months.” 


All aboard the ISS 


“We have a Raspberry Pi computer 
on the International Space Station, 
which is being programmed by 
school students,” said Dave Honess, 
programme manager for Astro Pi. 

“Think about how profound that 
is for a school student,” continued 
Dave, speaking at the Space for 
Inspiration conference. “You can 
have something you’ve made up in 
space; that’s what Astro Pi is.” 

Getting the Astro Pi devices on 
board the ISS in the first place was 
no easy feat for the Raspberry Pi 
Foundation, so it’s fantastic to 
see them doing a second mission. 
“If you want to fly anything to the 
International Space Station, even 
if it’s a small payload, you have 
to have something called a Flight 
Safety Certificate (FSC),” said Dave. 
“Our FSC was quite hard to get, 
because as an educational payload 
we were quite unusual.” 

The Astro Pi units went up for 
Major Tim Peake, a British ESA 


Our two Astro Pi devices, Ed and Izzy, are still hard 
at work on board the ISS (credit: ESA/NASA) 
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ASTRO PI BLASTS BACK INTO SPACE 


PIN AP.VIS.01 


AstroPi IR 


Astronaut. Tim manually uploaded 
code, developed by UK school 
students, to the boards. 

Before Tim left the ISS, he 
plugged in an Ethernet cable to the 
Astro Pi devices. “So we now have 
space-to-ground communications 


as 


AstroPi IR 


BENININAMII 


Above Ed and Izzy, the two Astro Pi devices 
flying on the ISS (credit: ESA/NASA) 
two very special items on board for 
me: two Astro Pi computers.” 

Each Astro Pi contains a standard 
Raspberry Pi 2 and a Sense HAT. 
“So get ready,” continued Thomas, 


We now have space-to- 
ground communications 
with the Raspberry P1 


with the Raspberry Pi,” said 
Dave. “We can remotely access it 
to deploy new student code and 
download experiment results, 
which we didn’t have in Tim’s 
mission. He had to take the SD 
card out and plug it into a laptop, 
which was time-consuming.” 


Ed and Izzy flying high 
“My friend and fellow ESA 
astronaut Tim Peake just finished 
up his ISS mission,” said new 
astronaut Thomas. “He has left 
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“since a lot of exciting science 
can be done with the Astro Pis. 
Pm very glad to invite you to join 
the Astro Pi School Challenge. I 
will challenge you to run a coding 
competition, based on the mission 
that I will assign you. 

“You may even have the 
chance to send your code to the 
Astro Pi on the ISS, where it will 
run in space,” said Thomas. 
“Have fun learning. I can’t wait to 
see all the code that you come up 
with. So, see you soon!” 


News 


ASTRO PI 
IN NUMBERS 


£2 
400km 


ABOVE THE EARTH 


£.2,900 


COST OF EACH 


ASTRO PI FLIGHT CASE 


£4,000 


COST OF ETHERNET CABLE FOR 
SPACE-TO-GROUND COMMUNICATION 


8,000 


PESPRONDEDHOESAS 
‘DO YOU WANT TO BE 
AN ASTRONAUT?’ AD 


£72 BILLION 


ESTIMATED VALUE OF ISS 


COST OF A 
RASPBERRY PI 


November 2016 


Rui Peixoto, 
Pedro Lopes, and 
Gonçalo Marques 

stand on top the 


AGV in the Peugeot 


8 


Citroén factory 


RASPBERRY PI 
ROBOTS 0000 


Robot controlled by Raspberry Pi carries cars around the factory 


he Raspberry Pi is taken 

incredibly seriously 

in engineering, with 
thousands of our favourite 


computers embedded in industrial 


projects around the world. 
Peugeot Citroén has taken 
the Raspberry Pi to heart. The 
company is using Raspberry Pi 
boards to revolutionise the way 
it builds cars. 
The jewel in its crown is this 
automatic guided vehicle (AGV) 
used in its Portugal factory. We 
spoke to Pedro Lopes, manager 
of the engineering department. 
“In our weld shop, the cars 
are transported in a wheeled 
iron structure that we call ‘the 
chariot’,” he tells us. 
Vitor Duarte, Peugeot Citroén's 
weld shop manager, challenged 
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The Raspberry Pi and other 
components live inside the white 
box on the front of the robot 


Pedro to build a low-cost, but 
reliable, solution for carrying 
the chariots “without using 
human hands”. The manager 

of IT infrastructure, Carlos 
Mesquita, sponsored the project. 
“He’s a believer in these types 
of solutions,” says Pedro. The 
Raspberry Pi AGV was born. 

“Our metalworkers made the 
completely iron structure,” 
recalls Pedro. “At the same time, 
the programmers, who are all 
Raspberry Pi fans, started to 
choose the components and began 
writing the code.” 

The result is a giant, 
autonomous robot, which is used 
to lift and move cars around the 
Peugeot Citroén factory. 


Chariot driving 
The AGV contains a Raspberry Pi, 

a touch display, a12-channel USB 
servo controller, and a RoboClaw 
ST 2x45A motor controller (which 
drives the two DC motors). 

A Roboteq MGS1600 magnetic 
band sensor is used to guide the 
AGV along the track that runs 
around the factory. “It travels 36 
metres per cycle,” says Pedro. 
“We currently have a production 
of 220 cars per day; it travels 7,920 
metres per day.” 

The robot sports a RoboPeak 
RPLIDAR 360° scanner for safety. 
“The RPLIDAR is used for people 
detection,” explains Pedro. So 
the AGV will stop automatically 
if a person is in its way. 
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he Alexa Voice Service 

(AVS) API for Raspberry 

Pi now includes 
hands-free functionality. 


“Any digital maker using the free 


API from the Amazon Developer 
team had to add a button to their 
build, putting a slight dampener 
on the futuristic vibe of the 
disembodied Alexa,” writes Alex 
Bate, Raspberry Pi’s social media 
editor. “We know about this 
because a bunch of you [makers] 
complained about it.” 

This update removes the press- 
a-button limitation. Makers can 
now use Alexa by issuing a wake 
word, calling out to “Alexa”, 
‘Echo”, or “Amazon”. 


HUMAN MACHINE 


If youw’re looking for ideas 
for builds, check out the 
Internet of Voice Challenge that 
Raspberry Pi and Hackster hosted 
(magpi.cc/2baErdf). Winning 
builds included a voice-activated 


Baseball Pitching Machine, a voice- 


controlled K’nex Car, and a Smart 
Cap for the visually impaired. 


The update to Amazon's Alexa 
API now enables Raspberry Pi makers to 
create hands-free devices similar to the 
Amazon Echo Dot 


INTERFACE Wo 


roy Miller, applications 
engineer at Galil Motion 
Control, has developed 
a human machine interface 
(HMI) using Galil software 
and a Raspberry Pi 
The result is a cheap, powerful 
HMI perfect for industrial 
environments, without having 
to use a full-sized PC. 
“There are many sources 
for HMIs, and many can cost 
thousands of dollars,” says 
Troy. The Raspberry Pi is a much 
cheaper option, but it also comes 
with a 7-inch touch display, and 
now it can run Galil’s motion- 
control software. 
“This powerful trio forms the 
foundation for an inexpensive but 
fully capable HMI, customised for 
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any motion-control application,” 
says Troy. 

“There are free software tools 
that can allow a person to create 
just about any interface to run on 
the Raspberry Pi,” he adds. “The 
software acts as the glue to take in 


the input from the user in the touch 


interface, and the Galil gclib API 


translates those simple instructions 


into the commands to send to the 
machine motion controller.” 

Troy has made an excellent video 
demonstration of a Raspberry 
Pi running Galil software to 
control a stepper motor linear 
stage (magpi.cc/2dSXGYu). 


The stories that made waves on 
our social media sites this month 


magpi.cc/2dT4FAM 


We were taken aback by the sheer weight of 
community love for the Top 50 feature (from The MagPi 
issue 50). Our Top 50 photo album got a huge amount of 
attention on Facebook. 


This project generated Ta 
lots of love on Twitter. 
James Mitchell's 


magpi.cc/2dT2Qnk 


ingenious device 

can take 360-degree 
panoramas and 

even time-lapses. It 
features eight Pi Zeros 
equipped with Camera 
Modules, placed 
around a laser-cut 
wooden housing. 


magpi.cc/2dT46qz 


Rob's review of the crowdfunded laptop that gamifies 
the hardware building process piqued the interest of 
our lively Google Plus community. 
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Tom Hartley, president of Imperial 
College Robotics Society; Amy Mather, 
winner of European Commission's Digital Girl 
award; and Matthew Timmons- Brown, The 
Raspberry Pi Guy 


ucky members of the 

Raspberry Pi community 

attended a special event at 
St James Palace on 5 October. 

The Duke of York, HRH Prince 
Andrew, invited members of the 
Raspberry Pi community to the 
event to celebrate all the good work 
that they do. 

Invitees were free to mingle with 
members of the community, and 
learn about Code Club and Raspberry 
Jam events, while taking in the 
splendour of the palace. 

There were inspirational speeches 
from the Raspberry Pi Foundation 
CEO Philip Colligan, Code Club UK 
co-founder Clare Sutcliffe, and The 
Duke of York himself. 

“The event at St James’s 
Palace was an opportunity for 
us to celebrate the awesome 
achievements of our community of 
makers, educators, volunteers, and 
young people,” says Philip Colligan. 
“More than anything, Raspberry 
Pi is a community and we really 
just wanted to say thank you for 
everything they do.” 


~ | 
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Raspberry Pi community invited to meet the Duke of York 
at St James’s Palace 


Hannah 
Belshaw, from 


Cumnor House Girls’ 


School in Croydon, 
was an Astro Pi 
winner with her 
idea to represent 
data from the Astro 
Pi in the world 

of Minecraft 


Maria 
Quevedo, Clare 
Sutcliffe, and 
Rik Cross from 
Code Club UK 


More than anything, Raspberry Pi is a 
community and we really just wanted 
to say thank you for everything they do 


Grand old duke 


“The Duke of York is patron of 
the Raspberry Pi Foundation and 
was also the patron of Code Club 
before we merged,” explains 
Philip. “So he hosted the event 
and gave a heartfelt speech about 
the importance of computing and 
digital making education.” 

Places for the event were 
extremely limited. “The only 
downside was that we could only 
fit 150 people in the room,” Philip 
tells us, “and, of course, our 
community is much, much bigger 
than that. That’s why we’re always 
thinking of more ways to celebrate 


and support our community to 
grow and achieve more.” 

The event came shortly after the 
news that the Raspberry Pi had sold 
over ten million units in total. It 
was a great opportunity to reward 
some of the community that had 
made this British computer such a 
success story. 


pr 
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This NEC display is seriously smarter 
than its rivals thanks to the Raspberry Pi 
Compute Module embedded inside 


WITH PI INSIDE 


Custom Raspberrry Pi Compute Module makes 
new NEC display super-smart 


EC has announced a new 
display with a Raspberry Pi 3 
Compute Module inside. 

“We think that the large-format 
NEC displays will be suitable for a 
very broad range of applications,” 
says Eben Upton, CEO of Raspberry 
Pi Trading. “Obviously digital 
signage applications, but there are 
also opportunities for interactive 
presentations and a broad range of 
IoT projects.” 

The Raspberry Pi Compute Module 
comprises the guts of a Raspberry 
Pi 3 board. Other projects can have a 
Raspberry Pi embedded inside. 

NEC has customised the Compute 
Module with a larger than usual 
16GB of flash storage. 

“People are using Raspberry 
Pis to add intelligence to their 
products,” explains Eben. “We’ve 
been fortunate enough to have sold 
10 million Raspberry Pis so far, and 
the commercial success has led 
to the third generation of a more 
mature and powerful technology 
which can be used with NEC’s 
intelligent display.” 


V404 
P404 
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Developer powered 
“Our work on the Raspberry Pi 
mini-computers is driven by the 
huge community of developers,” 
continues Eben. “Overall, this 
collaboration shows NEC’s 
confidence with our ability to 
provide a platform that can be used 
in a variety of environments.” 
“Integrating the Raspberry 
Pis with our displays will provide 
businesses with advanced technology 
suitable for digital signage, 
streaming, and presenting to 
enhance the overall visual experience 
at an affordable price point,” 
says Stefanie Corinth, senior VP 
marketing & business development 
at NEC Display Solutions. 
“It’s an incredible vote of 
confidence in the Raspberry Pi 
Compute Module platform froma 
blue-chip hardware vendor, and 
will hopefully be the first of many,” 
concludes Eben. 


The displays are designed for public 
signage and presentations; the range starts 
at a 40-inch size 


OPEN INDIRECT 
OPHTHALMOSCOPE 


This ultra-low-cost eye screening 
device uses machine learning to 
save eyesight in India 


r "The O10 scans the 
f retina and uses 

machine learning 
to diagnose 
problems. The 
touch screen on 
the front displays 
the diagnosis 


he Raspberry Pi is being used to save the 
eyesight of people in India thanks to the 
Open Indirect Ophthalmoscope (OIO) project. 

“The OIO is a portable retinal camera that uses 
machine learning to make diagnosis not only 
affordable but also accurate and reliable,” explains 
Sandeep Vempati, a mechanical engineer at the 
Srujana Center for Innovation. The device uses a 
Raspberry Pi to drive down the cost of diagnosis. 

“Currently, visual impairment affects 285 million 
people worldwide,” reveals Sandeep. “What's 
more surprising is the fact that 80 percent of all 
visual impairment can be prevented, or cured if 
diagnosed correctly.” 

“India is the diabetic capital of the world,” 
says Dr Jay Chhablani, a retinal disease specialist. 
“Diabetics affects the retina and leads to something 
called ‘diabetic retinopathy’. If we see the patient 
at an early stage of diabetes, we can treat these 
patients by controlling diabetes and applying 
laser treatment.” 

“3D printing creates the OIO for a fraction of the 
cost of conventional devices, and yet maintains the 
same quality,” says Sandeep. The OIO costs $800 to 
build. Conventional retinal cameras cost ten times 
as much. 

OIO’s Hackaday page (magpi.cc/2dVtqfN) lists the 
required components. “Engineering feels great when 
you see a product being useful in the real world,” 
enthuses Sandeep. 


The case is 3D printed, and the components are low- 
cost and widely available. The project is open-source so 
anybody can build one 
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MEET THE 


WINNERS oF 


PITOT SMARTER SPACES 


Element14 tasked makers with creating an IoT command centre using a Pi 3 


he element14 Raspberry 

Pi community is a pretty 

amazing place, especially if 
you want to catch some great Pi- 
related maker projects. In the past 
we’ve featured projects straight 
from here, like a super-scary 
haunted door and even a Pi Zero 
soldered into a CRT TV for retro 
gaming. Recently, the community 
held a design challenge called 
PiloT, with the aim to create 
‘Smarter Spaces with Raspberry 
Pi 3’. Using a Pi 3, contestants 
were tasked with creating a better 
command centre for all their IoT 
devices in a specific area. The 
winners were announced just after 
we went to print last issue, but 
they’re pretty cool so we thought 
we’d introduce you to them now! 
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And the winners are... 


Plant health smart camera 


Maker: Gerrit Polder 
magpi.cc/2ej7RnP 


Gerrit’s project isn’t even about 
an IoT home, but an IoT farm. 
This project uses two Pi Camera 
Modules, a normal one anda 

Pi NoIR camera, along with 
OpenCV to track plant health. 

It’s a contained system witha 
purpose-built display and a slave 
Raspberry Pi Model B+ to operate 
the other camera. This method 
uses the same technique as the 
Enviro Pi experiment that was 
carried out on the ISS for Astro Pi: 
Normalized Difference Vegetation 
Index (NDVI). The images are 


D device 


Ø controt 


D Radiator 
AN Sensor 


iBeacon 


X Light 


AN 
O 


} 


combined in this method, which 
can then be reviewed on the 
system itself. 


Thuis 


Maker: Robin Eggenkamp 
magpi.cc/2ejjbjS 


Thuis is a full home automation 
system with the Raspberry Pi at 
y Senas y Below A simple 
interface for Thuis 
that controls many 
parts of the house 


the core. The original brief was 
to have a smartphone greet you 
as you get home, and to have the 
1ouse react as you move through 
it. This has been accomplished, 
with lights turning on as you 
enter rooms and acustom UI 
that lets you control lighting, 
music, and other media aspects 


throughout the home. It’s a very 
powerful and complex system; 


Robin has also put together 


some fantastic documentation 
for it if you wish to follow in 


1is footsteps. 
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Element14’s community has regular challenges 
that people can enter - PiloT was the second 

of the year - and they always have pretty good 
prizes, too. PiloT’s first prize was a 3D printer, and 
the runners-up managed to go home with a huge 
selection of kit, including some power tools. Keep 
an eye out on the element14 contest pages for the 
next round: magpi.cc/2ejjgbB. 


ae 


With an included SD card preloaded with the Project 
Spaces installer, the WD PiDrive Foundation Edition 
lets you create independent work spaces for multiple 
projects on a single drive so you can switch between 
your creations on the fly. 
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feature 


= / 
BUILD A 
REMOTE, 
CONTROL 
ROBOT 


Make a Pi Wars-winning robot with our expert Brian Corteil 


his is no ordinary robot build. Over the next 

few pages, we are going to show you how to 

design, build, and program a robot capable 
of winning a robotics competition; the best part is, 
anyone can make one! 

In this feature, we will take you thought the 
steps required to build this amazing robot. 
We’ll look at different types of components 
you could select, how to program it, how to 
build it, and then how to control your robot. 
We’ll even have some tips for if you want 
to enter your robot into a competition. 
Read on and we can get started... 
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Six-wheel direct drive robots 

have most of the advantages of 
both tracked and wheel robots, 
offering good grip, high torque, and 
manoeuvrability. The use of multiple 
motors balances their output. 
Disadvantages for this type are the 


cost of six motors, wheels, and a motor 
controller powerful enough to supply 


the juice required. 


This is the robot we're building. The four-wheel direct drive 
chassis is acommon design for a robot, and can be bought 
as a kit from many stores. Four-wheel direct drive robots 
have many advantages over two-wheeled robots: they have 
more torque, more grip, they're faster, and are able to turn 
on the spot. This makes the robot nimble and very suitable 
for challenges like the maze and the obstacle course. 
Disadvantages include a higher cost due to the 
greater number 
of motors and 
more expensive 
motor controller 
to use them. 


Tank tracks are cool. They have loads of grip 
when matched to the surface you are running 
on, are great over rough ground, and you can turn 
on the spot. However, they can difficult to build. The 
alignment of the tracks needs to be spot on when 
installing them, or you will risk the track slipping 
off. Tracks can also be slower than 


wheels because there's 
more friction on them. 
Omnidirectional robots are 
great for avoiding your opponent 
in sumo-style contests like Pi Noon 
at Pi Wars, as they can move in any 
direction. The downside is they are not so 
great on rough ground due to the design of 
their wheels. The wheels are complex and can 
be quite expensive to buy, and you'll need to do 
a lot more coding on them. The maths behind 
getting it to work can be very cool, but it’s also 
scary enough to make you want to run and 
hide behind the sofa. 


CK YOUR 


How will the robot 
get around everywhere? 


otors come in many sizes, types, with/without 

gearboxes, etc. Common motor types used in 

maker projects are brushless, brushed, and 
stepper (see more details on the right). When selecting 
a motor, you need to consider its voltage rating, free- 
run current, stall current, and type. The free-run (or 
operating) current is how much current the motor will 
draw when running; with this information, you’ll be 
able to estimate how much power the robot needs. 

This is important for a reliable design, as 

you’ll need to match the motor and controller 
characteristics; if you use a motor that has a voltage 
rating higher than the motor controller, you won’t get 
the full potential out of the motor. If the stall current 
is higher than the controller’s peak output current, 
you’ll see ‘magic smoke’ come from the controller, 
which is bad. Another characteristic of the motor you 
need to consider is its speed: the higher the RPM of 
the motor, the faster it will turn the robot’s wheels/ 
tracks. For this robot, we’re using the micro metal 6V 
N20 motors from Pimoroni. 


MOTOR MARKINGS 
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No brushes to wear out 
More torque 

More power 

Better control 
Power-to-size ratio 


Complex & expensive controls 
Less rugged 
Cost 


High torque at lower speeds 
Simple control circuits 
Cost 


Shorter operational life 
Power-to-size ratio 


Precise control 
(turns in small steps) 


Complex controls 
Cost 
Slow 


Some things you'll see on a motor... 


The rated voltage of the motor. Can also be shown 
as ‘12V DC. DC means that the motor must be 
powered by a direct current source like a battery. 


Revolutions per minute. Can also be shown as r/min. 
The lower the number, the slower the motor is, so 
500 rpm is faster than 25 rpm. 


Not pictured on this motor. If a motor output is 
described as a ratio, the lower the number, the 
faster the motor, so 50:1 is faster than 254:1. 
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CONTROLLER 


Now we have motors, we need a way to use them 


otor controllers, like the name suggests, 
are used to control motors. There are many 
types available for the Raspberry Pi, so when 


selecting 
controlle 


the motor controller, you need to match the 
r to your motors. An important consideration 


in this selection is the support documents, libraries, 
and software examples. Features to look out for are 
inputs, outputs, servo control, and whether or not 
it can power the Pi from a single power source. The 


controlle 


r you select must be able to handle the 


battery voltage, the peak current of the motors when 


stalled, a 


TO 


nd be compatible with the Raspberry Pi. 


CONSIDER: 


piborg.org/zeroborg 


The ZeroBorg is the controller we're using in this project. 

It has a number of features that make it stand out from 

some of the other boards, such as its use of two TI DVR 8833 

H-bridges which allows for independent control of up to four motors. 

This makes it good for controlling an omnidirectional robot, or two 

stepper motors. You also can add/specify a DC-to-DC converter to power 
both the motors and the attached Raspberry Pi Zero. One final feature is the 
IR receiver, so you can control your robot with an IR remote control. 


magpi.cc/ipgwGaA 


A well-thought-out Pi Zero format controller from 4tronix, it uses the same TI 
DRV8833 motor driver H-bridge chip as the ZeroBorg. The extra inputs and outputs 

À are great for adding sensors, servos, and NeoPixels; there's even a dedicated socket 
i for an HC-SR04 ultrasonic sensor! The power arrangements are very flexible, as you 
can drive the motors from the Pi’s 5V rail or from a separate power source, from 3V 
to 11V. It’s also worth checking out 4tronix's ROboHAT if you're using a full-sized Pi. 


magpi.cc/1Pk5SdN 


The Pimoroni Explorer pHAT was the first Pi Zero-format motor driver HAT, 
and is an excellent controller. It uses the TI DVR8833 H-bridge again and has 
four 5V-tolerant digital and analogue inputs, plus four 500mA outputs. The 
various inputs give options for connecting different types of sensors, and the 
motor driver will happily drive a pair of N20 metal gear motors. For a full-sized 
Pi, use the Explorer HAT Pro. 
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Feature 


POWER 


YOUR ROBOT 


The perfect batteries to get your 


robot moving 


he correct battery can make a huge difference 

to your robot. It all comes down to four types 

for robots: lithium-ion, NiCad-based, lead 
acid, and dry cells. Battery technology has improved a 
great deal in recent years, thanks to the development 
of mobile phones, laptop computers, and tablets, 


with their requirement for high power and increased 
standby life. Whichever battery type you use, you’ll 
need a battery holder to connect them. 


NICAD / NIMH 


(nominal cell voltage 1.2V) 


NiCad / NiMH batteries 

were the number one choice 
before the rise of the lithium- 
ion batteries, due to their 
power-to-weight ratio anda 
predictable discharge voltage 
that changes little from 1.2V 


per cell until it nearly runs out. 


They’re packaged in common 
battery sizes, including AAA, 
AA, and PP3. Chargers are also 
commonly available, even 
being sold in supermarkets. 
The discharge rates are not 

as high as a lithium battery, 


but they don’t have a 
Mä Pi flammable metal in 
PICK 


their construction. 
We’ re using this 
type for our robot. 
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LITHIUM-ION 
INCLUDING LIPO 


(nominal cell voltage 3.7V) 


Lithium-ion-based batteries 
offer some of the highest 
energy density and energy 
release available. This means a 
robot powered in this fashion 
can use a smaller, lighter 
battery. Lithium batteries 

are more dangerous, though. 
There are two types of lithium 
batteries: type one has built- 
in safety circuits, to protect 
against under- and over- 
voltage and short circuit. Type 
two batteries have no safety 
circuits! If you wish to upgrade 
your robot to LiPo, make sure 
to be safe. 


LEAD ACID 


(nominal cell voltage 2V) 


The granddaddy of all 
rechargeable batteries, the 
lead acid battery was invented 
in 1859 by Gaston Planté. This 
type of battery has a very low 
energy density and is made 
of lead. This makes it a poor 
choice for use in a robot, 
although it can supply high 
surge currents. While larger 
lead acid batteries are used 

in most cars, they’re best 
ignored for this project due 

to their high weight and low 
energy density. 


DRY CELL 


(nominal cell voltage 1.5V) 


Zinc-carbon and alkaline 

are the more common types 

of dry cells, widely available 

in common battery sizes, 
including AAA, AA, and PP3. 
Although not rechargeable, 
they’re useful as an emergency 
replacement for NiCad / 

NiMH; however, you need to 
be careful with the increased 
voltage. They’re also expensive 
to continually replace. 
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Very small 

Very cheap 

Low power consumption 

More powerful than a Model A+ 


Limited USB connectivity 
Needs more soldering for GPIOs 
No on-board wireless or Bluetooth 


Respderry P 
© Mesprerry 


ue 
FCC 1D. 2nece-aPTaz 
T i ' 1 ICs 200S4-AP132 


The most powerful Pi 

Relatively low electricity requirement 
4x USB ports 

Wireless LAN and Bluetooth 


Higher power consumption than other Pis 
The biggest Pi 
Most expensive Pi 


í 3 -$ x ra 3 ¢ P, 4 
Fairly small > A ; BP 5 ; 
y +. oh "oe +. if MRSA 
Low power consumption e sii 


Standard-size USB port 


Bigger than Pi Zero 
Only one USB port 
No on-board wireless or Bluetooth 
Least powerful Pi 
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HOW TO 


For the chassis plates, you'll have to get them 
laser-cut - or cut them out yourself - from 3mm 
plywood, MDF, or Perspex (acrylic). It's also possible 
to convert files for 3D printing. 

You can download a PDF for the plates from 
GitHub (magpi.cc/2dx82h0). You'll also find a 
DXF file, plus the original Inkscape SVG files, so 
you can modify the design if required. Your local 
makerspace, hackspace, or fab lab may be able 
to help cut the plates. In the UK, there's also Eagle 
Labs. There are other online laser cutting services 
- try searching for ‘laser cutting services’ in Google 
and look for local ones. A top tip to remember: the 
plates’ edges should be cut last on the laser cutter. 


MagPi robot chassis files: magpi.cc/2dx82hO 


Hackspaces and makerspaces: magpi.cc/2dxbnxr 
Eagle Labs: labs.uk.barclays 
Fab Labs UK: fablabsuk.co.uk 


RazorLAB: razorlab.co.uk 
Laser Make: lasermake.co.uk 
Perspex (acrylic) supplier: kitronik.co.uk 


+ BULDING AN 


Get your screwdriver handy, as it’s time to make your robot 


Prepare the motors 
The motors must be modified slightly 
to make sure they fit under the 
chassis. Using a soldering iron 
and a pair of pliers, you should , 
remove the bent pins from 
each motor shim, suck out 
the solder, and solder 
some straight pins 
back in. Once that’s 
done, connect the 
wheels to the motors. 


Major compo nents: 


Attach the motors 

The motors need to be attached to the 
bottom plate using the brackets, as shown. 

i You can either have the wires connected now 
Connecti while it’s easier to do, or you can add them 
PP3 battery clip afterwards so they’re out of the way as you 

magpi.cc/2ebjlgV connect the rest of the motors. 

PP3 rechargeable battery 


Female-to-male jumper wires 
magpi.cc/2dvjMSb 

6x 3mm hole, 20mm length PCB 
spacer posts 

magpi.cc/2dvjKJR 


12x 3mm, 8mm length hex pan 
head machine screws 
magpi.cc/2ebkaWQ 


8x straight header pins for motors 
magpi.cc/2eeUbv9 

ptional camera: 
Camera holder 


Raspberry Pi Camera Module 


22 | MägPi November 2016 


Tidy the wires 

Once all the motors are connected, 
flip the bottom plate the right way 
up and make sure all the wires are 
connected to the motors. You can 
push them two at a time through the 
rectangular holes on the side, which 


A little bit of soldering — 
Solder the header for the ZeroBorg onto the Pi Zero. It should be 
positioned on pins one through six, as shown above. Make sure it’s 
soldered to the underside as in the picture as well! 


Make the brains 

Attach the spacers to the ZeroBorg and then follow that up 
by placing the Pi Zero on top, making sure the header goes 
over the relevant pins. The USB ports and HDMI port are 
on the same side as the ZeroBorg connectors - refer to the 
step 06 image, just in case. 


Construct the top part 

You can attach the power wires now if you wish - refer to step 09 

for the orientation - but either way, you need to 

then mount the ZeroBorg and Pi Zero combo to 
the top plate. It attaches to the shorter side; 
you’ll know as it’s the only spot you 
can slot in the screws. 


Check the battery wires 

If you haven’t already, connect the power wires to 
the central terminals, as shown. It’s important to do 
so in this order (positive on left, negative on right), 
otherwise you won’t be able to properly power the 
ZeroBorg, which in turn powers everything else. 


) Connect the motor wires 
A You can now start connecting the motors to the 
l ZeroBorg. Each motor has a pair of cables, and 

f Da they should all be connected in pairs, one after 
| è < another, in the remaining four pairs of 
ZeroBorg terminals. It’s a good idea to keep 
the right-side motors on the right and 
left-side on the left as well. It doesn’t 
matter which way around the pairs 

go in their individual terminal 

blocks, though. 


Tidy the robot up 

Tidy up the wires and connect the battery; it won’t 
turn the robot on until you move the jumper to the on 
position. Connect the wireless controller’s dongle and 
you’re ready to get programming, if all you want is a 
remote-controlled robot. 


Install ZeroBorg software 


Now you need to download the ZeroBorg software. 
Open a terminal window and enter the following: 


You should also install the joystick app for testing 
your joypad and mapping the buttons. See the ‘Using 
a gamepad’ section (bottom right) for more details. 

The button mapping for the game controller is in 
zbJoystick.py. Use nano to open the file, and find the 
line # Settings for the joystick. For the Rock 


Candy controllers used in our version, it should look 
something like this: 


It will probably come up as something like 


Plug your gamepad in and then run the 
following to find out how it's listed: 


CONTROL FROM 


Control your robot from your computer or 
smartphone and use the on board camera 


For this way of controlling the robot, you’ll have to switch out 
any game controller receiver for a WiFi adapter. Plug the Pi Zero 
into a computer and get the WiFi connected before continuing. 


Once that’s done, you need to find the IP address of the 
robot by opening a terminal window and using: 


Make a note of it - this is how we’ll connect to the robot 
from elsewhere. Then install OpenCV using: 


Once that’s done, you’ll need to download the PiBorg web 
interface. Back in the terminal window, use: 


This will create a folder called diddyborg-web. Enter the 
following commands to start the web server: 


It will confirm when the web server has started. Type the 
IP address you found earlier into a browser on your PC or 
smartphone (or even another Raspberry Pi!) and you’ll be able 
to connect to the robot and see through the camera. Disconnect 
the monitor and any peripherals, then go for a ride! 


To get the gamepad or joystick button numbers, 
install the joystick software with: 


/dev/input/jso. You can then test it using: 


Move each stick and press each button in turn. You will see the values 


change for the axis or button pressed in real-time. Make some notes so you 
remember which button is which! 


NEAL ISSUE! 


Come back next issue to learn how to add and use sensors 


to your robot to make it a true automaton 


i Wars is next April and has a load of different 

challenges; it’s a bit too late to enter them, 

but that doesn’t stop you from learning how 
to get your robot competition-ready by using some 
excellent robo-sensors. Come back next month for 
our guide on how to add and use amazing sensors to 


conquer these challenges. 


The Straight-Line Speed Test is autonomous, 

with only a start and stop button allowed for the 
starting and stopping of your robot’s run. The 
course is a straight run, just over 7.3m long, with 
walls 67mm high placed 522mm apart - very 
precisely. There are penalties if your robot touches 
a wall, plus points for each clean and completed 
run. Three runs must be attempted. Here are some 
methods you could use for this challenge... 


Novembe 6 


Find the walls and guide 
your robot down the centre. You could also 
use an IR light beacon placed at the end of 
the course and aim to keep the beacon in the 
centre of the image, while steering the robot 
down the centre of the course. 


Count the number of turns each wheel makes 
in a set time. The shorter the time, the more 
accurate it should be. 


Measuring the distance 
between the walls, steer the robot down the 
centre of the course. 


Set a bearing and follow it - distance 
sensors may be useful as a backup check. 


raspberrypi.org/magpi 


The Minimal Maze is new to the Pi Wars contest, and it is an 
autonomous event. It’s basically two right turns followed by 
two left turns in a course with 65mm-high walls. Additional 
points will be given for clean runs where the robot does not 
touch the walls, along with points for a completed run. 

Penalties are given for touching walls, rescue attempts, 
and non-completed runs. As the measurements for the maze 
are not given, it will not be possible to use dead reckoning 
to navigate the maze, so the challenge requires the use of 
sensors. Not counting access to a lidar (a laser radar!), we 
have a number of sensors at our disposal. 

You could use the Pi Camera Module and OpenCV to find 
the positions of the walls or determine their colour. The 
walls are colour-coded to their orientation, so you will be 
able to tell which way your robot is facing. 

It may be a good idea to use distance sensors to avoid hitting 
the walls. Another method would to drive forward until you 
are a set distance away from the wall, then turn 90 degrees, 
either clockwise or anticlockwise depending on whether you 
need to turn left or right, repeat until last turn, then drive 
forward to the exit. The use of wheel/motor encoders and an 
IMU may help. If you use the data from your first run, it may 
be possible to improve your next run’s time. i 
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Sadly, the pieces have yet 
to crush their opponents, 
as they do in the book 


Motors on an x- and y-axis 
select the appropriate 


piece to move 


‘WIZARD GH 


Quick 
Facts 


» Watch the 
set in action 
at youtu.be/ 
Z7xdFns5bVrA 


» The Wizard 
Chess Tour 
started in 
Harlow 


» After Harlow, 
it visited the 
Covent Garden 
Raspberry Jam 


» Inspiration 
came from 
Instructables 
user maxjus at 
magpi.cc/ 
2cnyoBo 


» It's wingardium 
leviOsa, not 
leviosAH 


Etched acrylic allows 
magnets to move the 
pieces from beneath 


A 


7 kad 
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19-year-old Bethanie Fentiman shocked her A-level classmates when she 
rocked up with a fully working Harry Potter Wizard’s Chess set as her final 


coursework assignment 


ethanie Fentiman can’t 

play chess, but when her 

imagination sparked and 
the opportunity presented itself, she 
brought the iconic game of Wizard’s 
Chess from Harry Potter to life using 
a Raspberry Pi, stepper motors, and 
possibly a little magic. 

For her A-level computing 
coursework, Bethanie took an idea 
that had been nestling in the back 
of her mind, and turned it intoa 
reality. Well, as much of a reality 


The open sides of the build allow for an 
interesting view of the working mechanism 
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one can create when the literary 
version includes battling chess 
pieces that leave their opponents 
crushed to rubble on the board. 
Luckily for Bethanie, she’s a 
self-proclaimed Jambassador, 
actively participating in the 
Raspberry Pi scene via the Kent 
Raspberry Jam. With a community 
of makers to support her, Bethanie 
knew that she could complete the 
build and got to work, researching 
similar projects online that used 
magnets and motors to ‘magically’ 
move chess pieces on a board. 
After an internet search for 
inspiration, she came across 
an Instructables build for an 
Arduino-powered chess-playing 
robot by user maxjus, and used 
the main concept as the basis for 
her build. The guide provided all 
the information Bethanie needed 
to build the physical structure of 
the board, allowing for drawer 


runners, gears and, of course, 

the electromagnet that would 
move each piece when required. 

A 4tronix PiStep board, along with 
two 28BYJ-48 stepper motors, took 
up the job of moving the runners 
and electromagnet into place, 
linked through to the Raspberry Pi. 

As mentioned previously, 
Bethanie didn’t actually know how 
to play chess. So when it came to 
inputting the legal movements of 
each piece, she had two options: 
learn fast, or cheat a bit. Opting 
for the latter due to the time 
constraints of her coursework 
deadlines, Bethanie researched all 
the possible moves of each chess 
piece and worked them into the 
code. She could always learn to 
play the game later on. 

A second issue, and one far 
more associated with the original 
material from which she was 
taking her inspiration, was what 


raspberrypi.org/magpi 


the pieces would do as they ‘took’ 
an opponent. In the book, each 
piece defeats its foes through 
‘barbaric’ means. In reality, 
Bethanie plans on an upgrade 

to allow for movement around 
pieces... though once she gets her 
belated invitation to Hogwarts, 
we’re sure she’ll incorporate the 
expected level of brutality. 

With the build complete and 
presented to her computing 
A-level class, Bethanie’s Wizard 
Chess was met with amazement. 

“When I said I was going to make 
it, they just thought I was going to 
write the code and come up with 
designs for the board. So when I 
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When I turned up with the fully 
moving and playable board at 
school, they were shocked 


Tens 


With so many new skills required, 
Bethanie thanks Ed Bye for helping 
her with the electrics of the build 


turned up with the board at school, 
fully moving and playable, they 
were slightly shocked.” 

And they weren’t the only 
ones. Upon finishing her board, 
Bethanie took it to the Kent 
Raspberry Jam, where Twitter 
soon exploded with praise. From 
the Jam, ‘The Wizard Chess Tour’ 
was born as Bethany and fellow 
Jam members took to the road and 
presented the project at Jams in 
both Harlow and Covent Garden. 

Now actively seeking an 
apprentice in the field, Bethanie 
plans on upgrading the build while 
continuing the Wizard Chess Tour 
at more Jams in the future. 


WIZARD CHESS 


Projects 


YOU'RE A (CHESS) 
WIZARD, HARRY 


>STEP-02 


>STEP-03 
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a VONOME 


> The LEGO 
ace A music box featuring old and new technology in perfect harmony 
ook around 
three evenings 
to build ith hammers hitting the He got the idea after seeing a presses on the Monome and 
> Joon's young bars of a toy glockenspiel couple of videos of Arduino-based lights them up accordingly. The 
daughter to play a tune, the music boxes a few years ago, while Pi then sends serial commands 
eee Monomepi sounds just like an working on a Conway’s Game of Life to an Arduino Uno connected via 
old-fashioned music box, but this Pi project using a Monome Grid, a a ProtoShield kit to eight servo 
AUU E ee Pi-powered contraption is based versatile piece of hardware thatcan motors, which move makeshift 
coffee stirrers on new technology... and on quite be used to control music and more. hammers to play glockenspiel notes 
and LEGO a lot of LEGO. “It was just my luck For the Monomepi, the Monome to match the pattern shown on the 
> APi 3 runs that the components fitted with is connected to a Raspberry Pi 3 Monome. On the latter, the user can 
the Python the LEGO bricks almost perfectly!” running a step sequencer program, switch buttons on and off to alter 
sequencing z : a z J ; 
ware reveals its creator, Joon Guillen. which registers the user’s button the sequence as it plays. 


» The project 
took around 
two months Driven by the servos, the hammers The user presses light-up 
to perfect hit the bars of the glockenspiel to É buttons on the Monome 
play the sequenced tune a N Grid step sequencer to 
; i program a tune 


While the Pi is the brains of the 
setup, an Arduino is used to 
control eight servos attached 
to makeshift hammers 
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The note-playing hammers are made from coffee stirrers 
stuck to LEGO blocks snaffled from Joon’s toddler! 


“The contraption itself took 
only two or three evenings to 
build,” Joon tells us. “I focused 


most of my energy on the software 


side, so the physical construction 
was almost an afterthought.” 

To build it, he borrowed a bunch 
of LEGO blocks from his young 
daughter. “They were the first 
things I thought of using. I 
haven’t the talent for crafts, 

and so LEGO was the quickest 
way to build the contraption. My 
daughter even added some blocks 
of her own in there!” 

While the construction was quick, 
the project as a whole took around 
two months, with Joon working 
casually over the course of several 
evenings and weekends. “Most of it 
was figuring out the step sequencer 
logic, Arduino code, and optimising 
performance.” The main Python 
program running on the Pi is 
based on a Monome library Joon 
had created for his previous project. 
“That took a very long time, as I 
had zero Python knowledge when 


a 


I started out. The library has since 
undergone several improvements 
through the years.” 
While Joon opted to control his 
servos via an Arduino, he says 
there’s no reason why anyone 
creating a similar project couldn’t 
trigger them from the Pi itself, 
using a suitable motor driver board. 
And if you’re lacking a Monome 
(quite an expensive piece of kit), a 
touchscreen could be used instead: 
“A web-based UI should work, too. 
Or, if one isn’t necessarily trying 
to make a step sequencer, push 
buttons or [a computer] keyboard 
are viable control alternatives.” 
As a part-time musician, Joon 
plans to sample the Monomepi to 
use in at least one of his tracks. 
He’s also looking to improve the 
project by “adding features to the 
step sequencer program, such 
as having more than 16 steps, 
and the ability to use multiple 
velocities. Other than that, I am 
trying to think of more ways to 
use my servos with the Pi!” 


Joon admits he was lucky that the servos 
fitted easily between the LEGO blocks, 
albeit with a bit of paper padding 
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» Pianolas were 
first developed 
in the late 
19th and early 
20th centuries 


» Original pianolas 
used bellows to 
push down keys 
with air 


» The keys in 
this pianola are 
pushed using 
electromagnets 


> It can play songs 
backwards 


» Lloyd originally 
used aplaymidi 
from the 
command line 


The touchscreen display enables 
users to control the Raspberry Pi 
and select MIDI tracks 


The MIDI file is used by the pianola 
to determine which keys to play 


A USB-to-MIDI cable is used to 
connect the Raspberry Pi to the 
Yamaha Disklavier's MIDI IN socket 


When one maker’s self-playing piano failed, he used a Raspberry Pi 
to repair it... and made it his pianola play even better than before 


’ve always wanted an 

pianola,” says Lloyd 

Bayley, the owner of this 
rather fantastic Yamaha Disklavier 
self-playing piano. 

Pianolas may look like regular 
instruments, but they don’t just 
make the sound of a piano. They also 
move the Keys all by themselves. 

Self-playing pianos have a long 
and distinguished history. “I was 
around the old paper roll, bellows- 
driven ones when I was a child,” 
Lloyd reminisces, “and I found 
them fascinating. I found this one 
at a Sydney piano shop and went 
to visit them for a demonstration 


36 | MagPi November 2016 


and decided to buy it on the 
spot... I’m still enjoying it after 
almost three years.” 

Pianolas are spectacular to 
watch. Classic versions were 
controlled by reams of paper with 
holes punched into them. You can 
see self-playing pianos in classic 
movies (particularly westerns 
and comedies). Modern pianolas 
have replaced the paper rolls with 
floppy disks and MIDI files. 

“The piano itself doesn’t store 
songs,” explains Lloyd, “as it has 
no on-board memory. Everything 
must be loaded via floppy drive or 
via the MIDI ports.” 


The electronic system uses 
programming to fire solenoids, 
“which are a bit like a little finger 
that prods the hammers to strike 
the strings,” says Lloyd. “The 
strike force can be varied, and 
they are thus able to play loud and 
soft notes with ease.” 

Lloyd’s Yamaha Disklavier 
eventually suffered a hardware 
fault. The 3.5-inch floppy drive, 
which was used to load the 
music files, stopped working. 
Rather than pay for an expensive 
replacement from Yamaha, he 
chose to use a Raspberry Pi with 
a touchscreen display instead. 
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The Raspberry Pi attaches to the 
back of the touchscreen with pre- 
installed mounting accessories. 
“To connect it to the pianola, I 
used a USB-to-MIDI converter 
cable and was a little surprised to 
find it was that simple.” 

Lloyd loaded the Raspbian Jessie 
operating system and tried to 
play a file on the command line 
with the aplaymidi utility. “I was 
going to write my own cataloguing 
and playing software and while 
researching it, I came across 
XPMIDI (magpi.cc/2cCfG9L), 


“It’s working and working 
well,” says Lloyd. “I have a few 
different playlists that I favour, 
and I also like to play manually as 
well. It’s a nice happy pianola to 
have around the house. 

“I have showed it to people and 
they are amazed, and think Pm 
very clever. However, it was quite 
an easy project, as most of the 
‘trickery’ is already in place. 

I just had to fit all the pieces 
of the puzzle together.” 

Lloyd tells us that his pianola 
project is mostly complete. 


It was quite an easy project, 
as most of the ‘trickery’ 
is already in place 


which does the job nicely. It has 
a GNU public licence, so you can 
modify it if need be.” 

The end result is a fully working, 
self-playing piano which is a vast 
improvement upon the original 
version. Lloyd is able to store far 
more songs, and a program that 
he developed for the touchscreen 
enables rapid access to his choice 
of a list of thousands of songs. 
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“I think I would like to have a crack 
at doing the reverse, so I could 
play straight into the storage on 
the Raspberry Pi.” This is a feature 
built into the pianola, but it writes 
directly to the floppy disk. 

“With a bit of extra software,” 
says Lloyd, “you could output 
through the MIDI ports back in. 
That will take a little research and 
is on the list of things to do.” 


«Siig A 


The pianola is quite mesmerising to watch, 


and plays songs with precision and perfection 


I 
EFF 


The Disklavier script launches the 
interfaces, enabling users to select 
songs via the touchscreen 
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Projects 


TEEFAX 


PETER KWAN 


Having worked as an engineer with 
teletext equipment for the last 12 years 
it was transmitted in the UK, Peter is an 
expert in the field. When not recreating 
teletext, he's out riding his bike through 
the valleys of Stroud. 
teastop.co.uk/teletext 


Teletext makes a comeback with the help of the Raspberry Pi 


efore the dawn of the 
world wide web, teletext 
was the best way of 
keeping up to date with the latest 
news, sports scores and other 
information. The BBC’s Ceefax 
O SENES teletext service continued in the 
for the Stroud 3 p 
Fringe festival UK right up until analogue TV 
transmissions ceased in October 
New Teefax ; eae 
contributors 2012. We still miss its no-nonsense 


are always approach and blocky graphics, 
welcome 3 


Peter built a 


o we’re delighted that teletext 
You can use has been revived by the Teefax 
Feler s lle project. Users can install the free 


page editor 
(magpi.cc/ 
2dsEZfG) 


Dave Honess 
has made a 
teletext QR 
code generator 


Teefax project founder 
Peter Kwan is a former 
teletext engineer 


Peter is 
developing 

a Muttlee 
multi-user live 
editing system 


To control the service, just use 
the teletext buttons on your 
TV remote, as usual 


100 Teefax 100 Fri 12 Aug 07:39/11 


ROUD BAMBOOZLE 1 
3 Fesreanps INDEX. as 


MR BIFFO. 


Ant nest wap: 
BenFA. . 


REMEMBER T( 


software (magpi.cc/2dssVeo) on 

a Raspberry Pi, connect its 3.5mm 

video output to a TV (via the SCART 

socket), then hit the teletext 

button on the remote control. 
Project founder Peter Kwan is 

a former teletext engineer who 

carried on working in the field 

as a hobby. “As the analogue TV 

network was being shut down, 

I was thinking 

about how I could 

generate my own 

teletext,” he 


recalls. With the idea of making 
a low-cost basic teletext inserter, 
Peter manufactured his own VBIT 
hardware and managed to get a 
full teletext service running on it. 
Initially, there was a practical use 
for the system. “There is a lot of 
hidden signalling in the teletext 
signal,” Peter reveals. “The BBC 
uses a system called Presfax which 
hides schedule information in 
databroadcast packets. They also 
have special signals that let 
London take over the whole 


= 


The data transmitted via the 
Pi's composite video signal is 
converted into teletext pages 
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P519 


0001 0002 0003 P> 
VBIT-PI 519 Wed OS Oct 11: 


s0001 
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Hair... 
here, 
hold: 
excess of domestic hair... 


is modern problem. 
hair there - hair everywhere. But 
For now there is solution to 


Hair 


HAIREATERS! 


* Your hand/plate 


Bath hole * Rear of husband * Cat’s 
Skneaeh * Sofa * Dofa? xX Other holes 
MUNCHMUNCHMUNCHMUNCHMUNCHMUNCHMUNCH ! 


DISCLAIMER: 


eating hair 
really like ible for anything else 


They’re a bit funny in 


be held responsi 
they might do. 


Our hair-eating specialists 


but we cannot 


d, and one of them once dida 
cies Eice off in a customers’s mouth. 


Along with news, Teefax pages include teletext art, quizzes, and some humorous 


articles from the likes of Mr Biffo 


network in an emergency.” In 
addition, betting chains use control 
signals to switch TV channels or 
mute audio in their shops, while 
European broadcasters use opt- 
out signals to insert local adverts. 
“These all need testing and VBIT 
was a low-cost and flexible way of 
generating these signals.” 

When the Raspberry Pi was 
launched in 2012, Peter soon 
realised it could be used instead of 
his bespoke hardware. “It had PC, 
SPI, and GPIOs to drive and it was 
cheaper than the AVR boards that I 
was using, so I hooked one up and 
it worked. I made a second spin of 
the board and called it VBIT-Pi.” 

The next big breakthrough came 
when Alistair Buxton managed 
to create a teletext signal direct 
from the video output of the Pi. “ 
bypassed the teletext stream from 
my hardware to Alistair’s software 
and instantly halved the cost of a 
teletext system,” says Peter. “The 


only thing that the Pi can’t do is 
overlaying from video, so things 
like subtitles and newsflash need 
an original hardware VBIT.” 

The Teefax server is actually 

an original Pi Model B running 
Subversion. “Apache handles 
u 
t 


ser authentication. PHP scripts 
riggered by Cron scrape the BBC 
ews website and update the news 
pages every day.” Currently, there 
are seven authorised contributors 
to Teefax. “The real number is more 
because people are welcome to 
submit their own pages and designs 
nd we will put them into Teefax for 
them.” To do so, you can use Peter’s 
wxTED page editor on a PC. 

Meanwhile, Peter is currently 
working on a more flexible version 
of the VBIT system with a much 
faster update speed. “This actually 
has a commercial application in 
the betting industry where a small 
delay in reporting the ‘off ina 
horse race can be costly.” 


jad} 
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VBIT-PI 
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pi-topCEED 


Viewing Angles 


14” 
HD Screen 


Modular 
Components 


$1149 


without Raspberry Pi 
ex VAT 


pi-top 


10 Hour 
Battery Life 


isis 
HD Screen 


Modular 
Components 


5264% 


without Raspberry Pi 
ex VAT 


Available in green or grey colours 


e 
i-to Worldwide shipping available in green or grey at www.pi-top.com 
Stay up to date with our latest news by following our social media 


CEEDuniverse 


CEEDuniverse is a world of fantasy 
grounded in computing reality! After 
crash landing on a strange new planet 
you will first encounter ‘drag and drop’ 
coding puzzles that improve your 
computational thinking skills. 


Discover more about the planet you've 
landed on and the civilisation that used 
to inhabit it while learning harder and 
more complex concepts in fun and 
engaging ways! Before long you'll be 
writing your own conditional 
statements, loops and functions. Find 
out more about CEEDuniverse at 
www.pi-top.com 


pi-topCODER 


Influenced by the workflow of makers 
and hackers, pi-top presents 
pi-topCODER - an integrated code editor 
which allows you to learn, write and test 
code all in one view. With intuitive 
syntax highlighting, dynamic views and 
customizable themes it makes for a 
versatile learning tool for your projects. 


pi-topCODER also has every Raspberry Pi 
Foundation lesson plan created and will 
track and save your progress as you go 
through dozens of fun hardware and 
software projects. 


x x 
pi-topPROTO pi-topSPEAKER 
pi-topPROTO is a HAT compatible Give a voice to your pi-top device 
Add-on Board for your pi-top or with pi-topSPEAKER! 
pi-topCEED that allows you to 
prototype electronics. Create a e Modular design, attach up to three 
Weather Station, HAM Radio, Heart in a row to give true stereo sound. 
Rate Monitor, or integrate any e 2W per module 
Arduino based maker kits into your e Left, Right and Mono mix selection 
own Raspberry Pi compatible e High quality SPDIF digital audio 
prototyping board! from HDMI 


e |?C controlled g 


Our Official ell wa ý% 
Distributors Sacatruit SẸ siice  Kiwi@Betectronics gşkuBİİ MODMYPI MQOENE & Pr$uoe.cn (RE sparkfun., 


The easiest way to set up a Raspberry Pi with Raspbian, 
and other operating systems, is to use the NOOBS installer 


NOOBS V1.9 - Built: Mar 18 2016 

a @ a 
$ g 

= Z A i 


Install (i) Edit config (e) Wifi networks (w) Online help (h) Exit (Esc) 


fÈ] Raspbian (RECOMMENDED) 
A community-created port of Debian jessie for the Raspberry Pi 


LibreELEC_RPi2 

= LibreELEC is a fast and user-friendly Kodi Entertainment Center distribution. # 

= f X Raspbian Lite | 
= Acommunity-created port of Debian jessie for the Raspberry Pi (minimal verso 


Data Partition 
Adds an empty 512MB ext4 format partition to the partition layout. # 


OSMC_Pi2 
A fast and feature filled open source media center 


Windows 10 IoT Core 
Windows for devices. Enables you to build projects and apps. 


Disk space 


Needed: 3944 MB 
Available: 6411 MB 


Format your drive All of the data 
Gn the Give will be lost when you = SS ap 


format a xe 


S0. SOHC and SONC Locos are trademarks of 
50-8, LLC 
Ratresh 
TAT GB Volume Label © 50 Card 


Format Option Option 
QUICK FORMAT. FORMAT SIZE ADJUSTMENT OFF 


tooa 
PSTRKTO 
covery emira 


seccwery ot 
Y 


A h 
RECOVERY PLES DO WOT OCT 
sermen, 

men beaten 


Needed OMB 
Avaistse 6411 0 


| vM0067611 


s0039 
Aadtreritn auw 
© he 


Needed 6 a 


Aw abate 


OS(es) installed 


i) OS(es) Installed Successfully 
= 


; ; 


For recovery mode, hold 


Raspberry Pi 


Raspbian Jessie 


@ with PIXEL A 


© To Desktop © To CLI 
Login as user 'pi' 
© Wait for network 

© Enabled © Disabled 


Network at Boot: 
Underscan: 


Rastrack: 
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vst T 
Options to expand the file system and change password 
and hostname sit alongside various login choices. 


Support for the various hardware and software 
features, such as Camera Module, SSH, and VNC. 


Perform 
Overclocking and GPU memory options can improve 
the performance of a Raspberry Pi. 


alis 
Set up an international keyboard, global WiFi options, 
and adjust the locale and time zone. 


ntetaces | Pectormance Localisation 


or = imagine, Program, S 


The stage is the same 

as before, and you can 
maximise it by clicking 
the blue square icon 


Create your code in this 


space and make your 
wildest dreams a reality 


Save and load your 


Step-by-step HowTo Blocks 


projects, just as you ~ 
could previously pr 


a tutorials to get started with your 


er 


| BE 


at 
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SCRATCH 2. 
ON RASPBERRY P 


Raspberry Pi 3 


46 


Get access to the upgrade for Scratch 
via some very easy steps 


cratch is an amazing piece of software that 

has helped many people take their first steps 

into the world of coding. We’ve done a fair few 
Scratch tutorials ourselves on the Raspberry Pi, but 
they always use Scratch 1.4, which is installed on the 
Raspberry Pi itself. 

Thanks to the recent updates to Raspbian with 
PIXEL, the official Raspberry Pi operating system, you 
can finally upgrade to the latest version of Scratch. 
It’s very easy to do as well, so get your Raspberry Pi 
out and let’s begin. 


>STEP-01 

Upgrade Raspbian 

You’ll need to do this in one of two ways: upgrading 
from a previous install, or downloading the latest 
release of Raspbian with PIXEL (magpi.cc/2ejN6sk) 
and writing it to a new SD card. 
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on your Raspberry Pi 


To upgrade from an earlier version of Raspbian 
to Raspbian PIXEL, open up the terminal and type 
the following: 


sudo apt-get update 
sudo apt-get dist-upgrade 


This may take a while and will probably require a 
reboot once you’re done. You’ll then be in the latest 
version of Raspbian with the PIXEL desktop. 


>STEP-02 

Update your Raspberry Pi 

The ability to use Scratch 2.0 is tied to the new 
browser, Chromium, being able to use Adobe Flash. 
This isn’t installed as standard with PIXEL, so you’ll 
need to update to get the Flash library. If you dida 
dist-upgrade to get PIXEL, then you may be able to 
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skip this step. Otherwise, close Chromium if you have 
it open, go to the terminal, and enter the following: 


sudo apt-get update 
sudo apt-get upgrade 


At some point during the upgrade process, you’ ll 
be asked in the terminal window if you want to install 
Flash; just press ENTER to accept. Once everything is 
updated, you’re ready to go. 


Find Scratch 2.0 
Scratch 2.0 is not a program you can install on your 
Raspberry Pi, but instead is an online editor you can 
use through the Chromium browser. This is good, as 
it means you can use Scratch anywhere, taking your 
projects easily between computers. It also means your 
old Scratch projects for Scratch 1.4 on the Raspberry Pi 
will still work on that version installed on the Pi. 

Open up the Chromium browser and head to the 
following address: scratch.mit.edu. 


Browsing the website 
From the main page, you can head straight to the 
editor by clicking the Create button at the top-left of 
the screen, or you can browse some examples if you 
want something more than just a blank canvas. There 
are also some games and programs that have been 
uploaded onto the website by other users to try out. 
Once you click through to anything, though, you’11 
need to right-click on the puzzle piece on the screen 
and then select ‘Run this plug-in’ for Flash to start 
working. It might take a moment to load the interface. 


Make something 
Scratch 2.0 works in mostly the same way as Scratch 
1.4, although there are some extra features you can 
make use of. As before, you place blocks to create 
code with loops, variables, and triggers. You can also 
upload sprites and music from your computer if you 
want to use more than just the defaults available. You 
can then save your files to your Raspberry Pi by going 
to File and then ‘Download to your computer’. 

Yov’ll also notice an ‘Upload from your computer’ 
option; this can be used to load the files you make 
in Scratch 2.0, and upload some of your Scratch 1.4 
projects as well. 


Compatibility 

Scratch 2.0 projects can sometimes have a hard time 
working on the version of Scratch that’s installed 

on the Raspberry Pi. As long as you have an internet 
connection, it shouldn’t be a problem, as you can run 
them in the browser. If you want to convert the files 
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Updating your Raspberry Pi is essential 
- make sure you do it regularly 


Contiguring rpi*chromium-mods) _-———————. 


Adobe Flash Player. Copyright 1996-2015. Adobe Systems Incorporated. All | 
Rights Reserved, | 
| 


Adobe and Flash are either trademarks or registered trademarks in the 
| United States and/or other countries. 


[Pe Bae eee mar 


This screen will show up during 
the upgrade process - just press 
ENTER to install Flash 


If you want to get stuck in with 
Scratch and make some cool stuff, 
you should check out our Scratch 
Essentials book, Learn to Code with 


|= 
WITH 


GOD 


Scratch. While it's written for Scratch 
1.4 on the Raspberry Pi, the projects 
should mostly work on 2.0 on the 
web as well. You can find the free 
PDF, along with other ways to get it, 
here: magpi.cc/Scratch-book 


to work offline in Scratch 1.4, you can try out the Retro 
Converter here: magpi.cc/2dtEUYW. 

It’s not perfect, though, so you may need to make 
some tweaks once you’ve done the conversion to get 
it working properly on the older version of Scratch. 
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Tutorial STEP 


Y STEP 


The Zero LiPo board 


fits neatly under the 


Enviro pHAT 


> A transparent, 
waterproof box 
magpi.cc/ 
2e8beBX 


> Pi Camera 
Module 


> Portable power 
source 


> hostapd and 
dnsmasq 
packages 


> Python Flask 
library 


> WiFi dongle 
(if not using 
a Pi 3) 


> Enviro pHAT 
(optional) 
magpi.cc/ 
29NHB3T 


> ZeroView 
(optional) 
magpi.cc/ 
2e89hWt 


THE HAYLER-GOODALLS 


Ozzy, Jasper, and Richard are mentors 
at CoderDojo Ham and gave a talk at 
the Raspberry Pi birthday party about 
their AstroPi adventures. 
magpi.cc/ilLmeoi 

@rdhayler / coderdojoham.org 


If you use a Pi Zero, 
you'll need a USB shim 
for the WiFi dongle 


-CAM 


Explore the underwater world with a Raspberry Pi camera 


here are plenty of underwater sports cameras 

available, but they can be quite expensive, 

especially if you want to control them remotely. 
In this tutorial we’re going to use readily available Pi 
add-ons to make a cheaper, customisable camera unit. 
There are lots of options and alternative sources of 
components for a project like this. For example, the 
Pimoroni Enviro pHAT is a really useful option that 
can report back information about the environment 
in which the camera is operating, especially how 
much light is available. There’s a fair bit of software 
configuration involved, but example config files are in 
the GitHub repo for this article (magpi.cc/2e8dtFk). 
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Find a suitable container 

This needs to be watertight and have at least a see- 
through lid. You can find Tupperware boxes with a very 
tight seal, but these tend to be translucent rather than 
transparent. The size of box will probably determine 
your choice of Pi and power source. Zeros are great as 
they’re so small, but then you’1l need a WiFi dongle and 
shim. You can also save space by using a LiPo battery 
instead of a power bank, although you’ll need a boost 
regulator too, such as the Pimoroni Zero LiPo. 


Configure your Pi to be a WiFi access point 
Start from a fresh Raspbian Jessie Lite SD card and 
install the following: 


sudo apt-get update 
sudo apt-get install -y dnsmasq hostapd python3 
python3-dev python3-flask python3-picamera 

First, configure your wireless interface to have a 
static IP address by editing /etc/network/interfaces. 
Then set it to not use DHCP by adding this line: 


denyinterfaces wlan@ 
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...to the end of your /etc/dhcpcd.conf file. Next, 
create the /etc/hostapd/hostapd.conf file, using the 
example in this tutorial’s GitHub repository as 

a template. Change the interface, ssid, and 
passphrase parameters as needed. Finally, edit /etc/ 
dnsmasq.conf, ensuring that the IP addresses are 
consistent with your settings in 
/etc/network/interfaces. Then reboot! 


>STEP-03 

Add the Enviro pHAT 

You have the option of soldering this board directly 
onto the Pi’s GPIO pins, or you can use the supplied 
female header if you want to reuse it in other projects. 
After that, install the Python library and dependencies 
using the following command: 


curl -sS https://get.pimoroni.com/envirophat | bash 


The library comes with some example programs 
and you should run these to test that everything 
is working correctly. 


>STEP-04 

Fit everything into your container 

To cut down on reflections and get the best possible 
images, the camera should be as close to the 
transparent side of your container as possible. The 
ZeroView from the Pi Hut is a clever mounting plate 
that uses suction cups and will also hold your Pi 
securely. Alternatively, you could make a mount 
out of cardboard and glue this to the inside of the 
container. Velcro tape can be a good solution for 
power sources (which normally need to be removable 
for recharging). 
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AQUAPI-CAM Tutorial 


+ Video Off Stills QuickSnap Take 


& 
E 
`a s 
i i = a. 
You'll still have to get pretty close to the water yourself 


The web interface shows environmental information 
and lets you control the camera 


>STEP-05 

Add some code, HTML and CSS 

Clone the entire Flask folder from the project 
repository onto your Pi. Flask is a small web 
framework written in Python which allows you to 
create simple web services; in this case, it’s a webpage 
that allows us to see data from the Enviro pHAT 

and the latest captured images. We can also switch 
between recording modes (movie or continuous still 
frames) or take photos on demand. This control of the 
camera is achieved via the excellent Python picamera 
library. You could enhance the project by adding 
additional exposure and shutter speed controls to 
your interface if you want. 


>STEP-06 

Set the code to run at boot 

To set the AquaPiCam program to run when the 
Pi boots up, add this line to your /etc/rc.local file, 
immediately above the exit @ line: 


python3 /home/pi/Flask/apc.py & 


It’s also a good idea to configure the Pi to only boot 
to the command line, using: 


sudo raspi-config 
...and selecting ‘console’ under option 3. 
Now go and find somewhere wet! You might 


want to run a few tests in the bath before venturing 
further afield! 
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B venu a) = m Q «aP*point c- home/pi - m pi@raspbeny: ~ j 


is ff a 


File Edit Search View nen oject Build Tools Ip 
Wastebasket ile Edit Search View Document Project Build Tools Help 


biah na: d4|Q 
include <stdio.h> A H 
n tdi An assignment of a pointer 
void main (void) - initialises the pointer to 
int a; point at a specific variable 
int *ptr_to_a; 
ptr_to_a = &a; 
a=5 
printf (*The value of a is ‘“d\n", a); 
“ptr_to_a = 6; 
printf ("The value of è is d\n’, a); 
prantf (*The value of ptr_to_a is Sd\n", ptr_to_a); 
i7 printet (*1r stores the value ud\n", *ptr_to_@); 
is printf ("The address of a is d\n, 6a); 


A declaration for a pointer to an 
integer variable - in effect, an 
address containing an integer 


AN INTRODUCTION TO C 


POINTERS 


Pointers: variables have addresses as well as names... 


he term ‘pointer’ has struck fear into the Let’s look at a simple example: 
heart of many a beginner C programmer, but 
once you’ve got your head around them, they #include <stdio.h> 
are a very useful feature of the language. They aren’t void main (void) 
actually that complicated in reality. { 
Remember when we looked at the declaration of int a; 
* AND & variables? Declaring a variable - telling the compiler int *ptr_to_a; 
what type it is and what it’s called - before you can ptr_to_a = &a; 
When first use it is necessary in C, because the declaration a=5; 
cee aie enables the compiler to allocate a block of memory printf ("The value of a is %d\n", a); 
may find it to store the variable. So for every variable you *ptr_to_a = 6; 
helpful to say declare, there’s a block of memory which is set aside printf ("The value of a is %d\n", a); 
Speer ening by the compiler for that variable, and the compiler printf ("The value of ptr_to_a is 
is doing: an * is remembers which particular block of memory is used %d\n", ptr_to_a); 
n PP for each variable. printf ("It stores the value %d\n", 
5 the SA What is a pointer? intf (" a 
of”. Once you H printf ("The address of a is %d\n", 
have got those A pointer is just the address of a block of memory &a); 
two ideas with a variable in it - that’s all there is to it. So } 
fixed in your : j j 
head, you've if you declare a variable and a pointer to that 
pretty much variable, you can access the value in that block of Taking it line by line, the first line is one we’re 
G memory in two ways: either with the variable name, already familiar with: we declare an integer variable 
: or with the pointer. called a. But what’s this? 
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int *ptr_to_a; 


This looks like it’s declaring another integer 
variable, doesn’t it? But look more carefully: the 
asterisk (*) at the start of the variable name indicates 
that this isn’t declaring an integer variable, but a 
pointer to an integer variable. 

So we now have an integer variable called a, and we 
have a pointer to an integer variable, called ptr_to_a. 
But neither of these actually have a value in them yet. 
It’s all very well calling the pointer ptr_to_a, but it 
has no idea what (or where) a is, so let’s fix that: 


ptr_to_a = &a; 


This is the important bit! In C, the symbol & before 
a variable name means ‘address of the variable’, so 
&a means ‘the address in memory of the variable a’. 
And as we said above, a pointer is the address of a 
variable. So this line initialises ptr_to_a to be the 
address of a; ptr_to_a is now a valid pointer to the 
variable a, so we can now use it. 

The next two lines are familiar; we set a to be 5, and 
just to check that worked, we print its value. So let’s 
try doing the same thing, but with the pointer: 


*ptr_to_a = 6; 


We're using the asterisk differently here. When 
declaring a variable, putting an * before its name 
indicates the variable is a pointer. But once the pointer 
exists, putting an * in front of its name means ‘the 
variable pointed to by this pointer’; this is known as 
dereferencing the pointer. So this line tells the compiler 
to set the variable pointed to by the pointer ptr_to_a to 
6. We know that the variable pointed to by ptr_to_a is 
a, so this line is just another way of setting a to 6; and if 
we print the value of a, we find it has changed to 6. 

The next lines should help you to understand 
the relationship between pointers, variables, 
and addresses: 


printf ("The value of ptr_to_a is %d\n", 
ptr_to_a); 


In this line, we’re printing the value of ptr_to_a; 
not the value it’s pointing at, but the value of the 
pointer itself. This prints a very large number, as it’s 
the address in memory where a can be found. 
printf ("It stores the value %d\n", *ptr_to_a); 

In this line, we’re printing the value pointed to by 
ptr_to_a; note the asterisk before the name. This 


prints the value of a. 


printf ("The address of a is %d\n", &a); 
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Finally, in this line, we’re printing the address of a 
itself, the same as the value of ptr_to_a we printed above. 
The crucial thing to remember when working with 

pointers is this: you can’t just declare a pointer, 

you need to also declare and associate the variable 
you want it to point to. When a pointer is created, 

it points at a random location in memory; if you try 
and write something to it, you can cause all sorts of 
errors. Always make sure your pointers are pointing 
at something before doing anything with them. 


Void pointers and casting 

You can also define a pointer without saying what 

type of variable it’s pointing to; this is a void pointer, 
written as void *. A pointer is just an address in 
memory, so we don’t necessarily need to know what’s 
at that memory. To use a void pointer, you need to cast 
it: tell the compiler what sort of pointer to treat it as... 


#include <stdio.h> 
void main (void) 
{ 
int intval = 255958283; 
void *vptr = &intval; 
printf ("The value at vptr as an int 
is %d\n", *((int *) vptr)); 
printf ("The value at vptr as a char 
is %d\n", *((char *) vptr)); 


We initialise the void pointer vptr to point to an 
integer variable called intval. 

In the first printf statement, we insert (int *) 
in front of vptr before we dereference it using *. This 
casts vptr to an integer pointer, and so the value of 
intval is printed as an integer. 

In the second printf statement, we insert (char *) 
in front of vptr before we dereference it. This casts vptr 
to a char pointer, and so what is printed is the value 
of the char which makes up the first byte of intval. 


What do you use pointers for? 

Why bother with pointers? We can already access 

a variable with its name. There are several ways in 
which pointers are useful, which we will explore in 
the future. But a few of the important ones are: 


FUNCTION CALLS - in the next instalment we will look at 
how to split up C code into functions; pointers are very 
useful for allowing a function to return multiple values. 
STRING HANDLING - in C, a string is a continuous block of 
memory with a letter stored in each byte; pointers make 
it possible to perform efficient operations on strings. 
ARRAYS - C allows array variables — lists of values of 
the same type - which, like strings, are stored in a 
continuous block of memory; pointers make accessing 
arrays easier and more efficient. 


Tutorial 


INCREMENTING 
POINTERS 


You can use 
++ and -- on 
pointers, but 
you need to 
be careful. 
(*a)++ 
increments 
the value 
pointed to by 
a, but * (a++) 
increments the 
pointer itself 
rather than the 
value it points 
at; this will 
move a to point 
at the memory 
address 
immediately 
after a. 


ALWAYS 
HAVE 
SOMETHING 
TO POINT TO! 


It's worth 
stressing this 
again: a pointer 
is not a piece 
of memory, it's 
just an address 
of memory. If 
you want to do 
anything with 

a pointer, you 
need to declare 
something for 
it to point to 

as wellas the 
pointer itself. 


MEMORY 


Pointers are 
one of the 
ways C allows 
(or in some 
cases forces) 
you to think 
about what 
the actual 
hardware 

of your 
computer is 
doing; a good 
understanding 
of pointers 
gives you 

a good 
understanding 
of how the 
compiler 
handles 
memory. 
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Rachel-Chloe is an engineering grad 
Emojis representing who's around ' who now gets to make Internet of 
Trigger actions like an SMS based are sent to your dashboard on A M Things projects for a living at Initial 
on when someone comes or goes Initial State's website State, a data visualisation service. 


initialstate.com 


=F = All you need 
is an internet 


mM ©) es) Biwho's at the office? feedback support rachel@initialstate.com connection 


# Edit Tiles 04:2 321 PM 14:23:26 PM 


KNOW WHO'S AT HOME 


Set up a sensor-free presence detector to let you know 
when someone’s close enough to connect to the WiFi 


ooking for an easy and useful project for Update your Pi and install arp-scan, an Address 
> USB WiFi that Pi you just have lying around? Find out Resolution Protocol packet scanner that shows every 
adapter who’s home and who’s not, or when your active IPv4 device on your local internet: 
BERR favourite coworkers are at the office, with just a Pi 
and an internet connection! This WiFi-based presence sudo apt-get update 
detector will take hardly any time at all, and you’ ll sudo apt-get install arp-scan 
suddenly have a base for triggering all sorts of things 
when someone is detected, like that theme music Once arp-scan is installed, you can test it with: 


you’ve always wanted. 
sudo arp-scan -1 


Presence detection 


The way that we’re going to detect ‘presence’ is by You should see a list of devices and corresponding 
scanning the WiFi network for certain devices’ MAC MAC addresses run down the screen, it could take a 
addresses, the unique identifiers that your phone or little while to load if on a large network. 

laptop gives when connecting to a network. Detecting A quick Google search will tell you how to find 
devices can also be done via Bluetooth; however, not your particular phone/laptop MAC address, usually a 
everyone will always have their phone’s Bluetooth series of 12 letters and numbers separated by colons. 
turned on, so WiFi should be a bit more reliable. You can check to see if your device appears on the 
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>PYTHON 3 


SENSOR-FREE PRESENCE DETECTOR 


arp-scan list of devices if the following command 
returns an address: 


names. The address array contains the corresponding 
MAC addresses for our phones. If you want to add more 
devices, simply add more values to both arrays. 

You’ll also need to replace YOUR_ACCESS_KEY 


sudo arp-scan -1 | grep DEVICEMACADDRESS DOWNLOAD: 


magpi.cc/2dDyuoV 


If your phone was found, the command will output 
its address. If it wasn’t found, make sure that it’s 
connected to the same WiFi network as the Pi (or vice 
versa). You may also need to wake up your device, as 
many devices disappear when they ‘sleep’. 


Initial State 


We’re going to use Initial State to create a real-time 
dashboard showing who’s at the office and who isn’t. 

Go to app. initialstate.com/#/register/ and create a 
new account. Install the Initial State Python module 
on your Pi: 


\curl -sSL https://get.initialstate.com/ 
python -o - | sudo bash 


You will be prompted to create an example script; 
this isn’t essential to installing the module, but can 
help test your ability to stream to Initial State. 


The code 


You can clone the GitHub repo to get the 
presence.py script: 


git clone https://github.com/initialstate/ 
pi-sensor-free-presence-detector.git 


We use threading to create separate pieces of code 
that run at the same time as each other. This allows us 
to look for more than one device on the network more 
reliably. The subprocess module lets us call arp-scan 
within our Python script. 

To customise the script, change the arrays of names 
and addresses to match your own. In this use case, we’re 
tracking who’s at the office, so we have an array with our 


This small setup would fit perfectly in a 3D-printed enclosure 


or 


ThePiHut 
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with your Initial State access key, which can be found 
on your Initial State Account page. 
Run the script with: 


sudo python presence. py 


Watch what prints to the terminal to make sure 
your devices are being detected, and that streaming 
is working. Head over to Initial State to check out 
your dashboard! 


Run from boot 

To make this truly useful and reliable, we need to 
handle any network issues. We found the easiest 
solution to be rebooting the Pi whenever the network 
connection drops. First, we need to create a script to 
check the WiFi and then trigger shutdown: 


sudo nano /usr/local/bin/checkwifi.sh 


Place the following inside the file, making sure to 


replace the IP address with the IP address of your router: 


ping -c4 IP_ADDRESS > /dev/null 


if [ $? !=@ ] 
then 

sudo /sbin/shutdown -r now 
fi 


The ping checks for a connection. If it returns 
with a non-zero exit code, the script sends the 
shutdown command. 

Save and exit the script. Now make sure its 
permissions are in order: 


sudo chmod 775 /usr/local/bin/checkwifi.sh 


Running a script from boot on the Pi is pretty 
straightforward with the service crontab: 


sudo crontab -e 


Pick your favourite text editor (such as nano) and at 
the bottom of the file, under all of the comments, add 
@reboot nohup sudo /usr/bin/python /home/ 
pi/presence.py & to run the presence.py script. If 
you named your script something else or put it ina 
different directory, replace /home/pi/presence. py 
with the correct path. Then, under that, add */5 
* * * * /usr/bin/sudo -H /usr/local/bin/ 
checkwifi.sh >> /dev/null 2>&1 torunthe 
checkwifi.sh script. Exit crontab and reboot the Pi to 
run your new presence detector! 


TRIGGERING 
AN ACTION 


Easily set up 
SMS or email 


alerts within 
Initial State or 
customise the 
code to make 
the Pi trigger 
something. 


EMOJIS 


You can 
change 
the emoji 
icon in your 


dashboard 

to represent 
your personal 
use case, such 
as a house or 
hospital. 
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You'll 
Need 


> 2x HC-SR501 
PIR sensors or 
equivalent 


> 2x Common 
anode red / 
green LEDs - 


diffused case Play the classic statues game with the Raspberry Pi as the arbiter, 
Tace aa which also supplies the music 


> 2x 1.2nF surface- 
MELONS ESTES he coming festive season often involves 

> 9-way ribbon playing games, and musical statues is one of 
ce the classic favourites. For anyone who is not 

> Stripboard familiar with the game, it involves players dancing 

> Angle aluminium a a around to music. When the music stops, they must 

\ adopt a pose and hold it like a statue; the player first 

to move is out. In this version there are two players 

who face off against each other, and PIR (passive 

infrared) sensors detect who moves first. For some 

unknown reason, all participants seem to also pull a 

funny face when freezing. 


> MDF board 


> Assorted nuts 
and bolts 


The circuit 
The sensor we chose to use is the very low-cost 
HC-SR501 PIR, although most others would probably 
work. Unfortunately, it does not have an ideal operating 
characteristic for this application, but luckily this is 
easy to fix. In the retrigger mode, the output goes high 
for a minimum amount of time set by an adjustment 
pot. Then, if more movement is detected during the 
high output time, the timer is triggered again and the 
output doesn’t go low until no movement is detected 
for the minimum high time. When the output goes 
low, it stays low for a fixed time and then the sensor is 
activated again, ready to respond to movement. While 
this behaviour is fine, what is not suitable for our game 
arbiter is the actual duration of these times. Even with 
the adjustment pot set on the minimum value, the delay 
obtained on the pot is approximately 5 seconds. The 
fixed time to activate the sensor again is about 3 seconds 
and has no adjustment control. Therefore we require 
a bit of hacking to shorten these times. This is done 
simply by replacing two capacitors with smaller ones. 
These are surface-mount ones; that might put some 
people off, but it is simple if you have a pair of tweezers 
Red/green LEDs indicate and a fine-tipped soldering iron. 
eee eines Hs a een orleft Wiring up these sensors is easy: just 5V and ground 
and the output is an open drain configuration, so 
simply wire it up to any GPIO pin and enable the 
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3V3 3V3 


Left LED Right LED 


150R 150R 150R 


GPIO4 GPI017 


150R 


GPIO27 GPIO22 


5V 


Left PIR 
HC-SR501 


Right PIR 
HC-SR501 


3V3 5V 
3V3 5V 


GND GPI018 GPI023 


Raspberry Pi GPIO 


Fig 1 The circuit diagrams for the project 


R ‘| G 


Anode 
LED pin out 


pull-up resistors. The indicator for each side is a red/ 
green LED of the common anode type. This means 

to turn it on, the GPIO pin is set to zero. Using a 
150Q, resistor gives 10mA through each LED, which 
is quite bright enough. The full schematic is shown 
in Fig 1; see the step-by-step section for details of 
construction. Note that when powering up, it takes 
about a minute before the sensors respond, as they 
have to auto-calibrate. 


The game 
The game is split into four phases: 


1) SETUP - the sensors wait until there has been no 
movement on either side for a time given by the 
startDelay variable. When this occurs, the music 
starts and the game progresses to the next phase. 


2) RUNNING - the movement sensors are monitored, 
the music is looped if the file has ended, and the LEDs 
show movement, until the time in the playDuration 
variable is exceeded and the music stops. Then the 
game progresses to the next phase. 


3) WINNER — when the time for the players to freeze, 
given in the stopDelay variable, has expired, the 
sensors are monitored to see who moves first. The 
winner is then displayed and the winner’s LED is lit 
up yellow. After a small delay, the game progresses 
to the last phase. 


4) RESTART - the game will halt until the computer 


operator presses the space bar. The game now goes 
back to the first phase. 
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BUILDING THE STATUES 
CONTROLLER 


>STEP-01 


Modify the sensors 

Locate capacitor CY1, under the pot delay RT1; and CY2, just above the 
ground pin. Remove them by quickly alternating your soldering iron 
from one end to the other until both ends melt and you can flick it off or 
grab it with tweezers. Clean the pads with some solder braid to remove 
all the solder; work quickly so you do not lift the pads. Then replace 
them with a 1nF to 1.5nF capacitor- we used a 1.2nF. Cut a 30mm length 


of 18mm by 6mm strip pine for the mounting stick and paint it if you like. 
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>STEP-02 

Make the PIR mounts 

Make four brackets 11mm wide 
from 2mm thick asymmetric 
aluminium channel 12mm by 
24mm by 24mm. Drill 2mm holes 
in the short side to fix the PIR 
sensor to the bracket with an M2 
nut and bolt. Cut the long side 

of two brackets down to 18mm 
so they do not overlap when 
attached to the sensor. Drilla 
3mm hole in each long side so you 
can fix it to the stick with M3 nuts 
and bolts. Make sure the brackets 
do not foul any of the PCB tracks; 
assembly can be fiddly anda 
miniature spanner helps. 


>STEP-03 

Add the electronics 

The few electronic parts fit ona 
piece of 6 by 24 hole stripboard, 

the copper strips running along the 
short side. Drill three 1mm holes 
through the stick to allow the LED to 
be mounted on the other side. Wire 
the power and signal connectors of 
the PIR sensors through a three-pin 
header socket to the board. Then 
wire it all back to the Raspberry Pi 
through a length of 9-way ribbon 
cable. Attach the ribbon cable to the 
stick with double-sided sticky foam 
pads, and make a 30mm bracket 
from 25mm by 15mm asymmetric 
aluminium angle and fix it to an MDF 
board about 100mm by 200mm. 


The software 

The statues.py program is written as a state machine 
following the game phases. The stages of the game 

are displayed in a small window and simply display 

an image consisting of the words/instructions for 

the current phase of the game. It uses the Pygame 
framework and the streaming music function to make 
sure that the music continues at the same point for the 
next round when the game resumes. 


Taking it further 

We recommend the game is played as a ‘best of three 
and you are out’ mode, but there is no software to 
enforce that, so you might like to add some, or even 
keep a score of the rounds won by each player. It is 
best played at one end of aroom, but you might have 
to put some sort of a screen in front of the sensors 

to stop any movement from the audience interfering 
with them. You can replace the tune played with your 
own; the tune in the GitHub repository is one we wrote 
here at the Bakery — it might be a bit techno for some. 
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dtalues.py 


oT. 
02. 


#!/usr/bin/env python 
# Statues 


935 


04. 
o5: 
06. 


import time, pygame 
import os, sys, random 
import wiringpi2 as io 


07. 


08. 
09. 
10. 
wy 


12; 
IS; 


pygame.init() # initialise pygame 
os.environ['SDL_VIDEO_WINDOW_POS'] = 'center' 
pygame.display.set_caption("Statues") 

screen = pygame.display.set_ 
mode([300,100],0, 32) 

pygame.mixer.quit() 
pygame.mixer.init(frequency=22050, size=-16, 
channels=2, buffer=512) 


14. 


15; 
Als} 


es 
18. 
197 
20. 
2A 
22% 


23. 


24. 


pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame. 
KEYDOWN, pygame . QUIT] ) 
moveSound = pygame.mixer.Sound("sounds/s®.ogg") 
pygame.mixer.music. load("sounds/tune.wav") 
pygame.mixer.music.set_volume(1.2) 
pygame.mixer.music.play() 
pygame.mixer.music.pause() 
imageNames = ["ready","still","dance","freeze", 
"leftWin", "rightWin","play"] 
messages = [ pygame.image. 
load("images/"+imageNames[m]+" .png”) 

for m in range(@,7) J 


25: 


26. 


PT 
28. 
29% 
30. 


Bile 
325 


setup = @ ; running =1; winner = 2; rstart = 3 
# state machine constants 

status = rstart # state machine status 
stillTime = 0.0 

startDelay = 2.0 # period to hold before game starts 
stopDelay = 3.0 # period to wait after music 

# stops before looking at sensors 

playDuration = 4.0 # time the music plays 
restart = False 


33). 


34. 
35; 
36. 
Bila. 
38. 
39 
40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
50; 


def main(): 
global leftMovement,rightMovement, status 
initGPIO() 
print"Statues game" 
prints Esc to quit? 
leftMovement = False 
rightMovement = False 
while True: 
checkForEvent() 
if status == setup: 
settingUp() 
if status == running : 
gameRun() 
if status == winner : 
gameWinner() 
if status == rstart : 
gameRstart() 


els 


52 


Dar. 
54. 
DDI. 
56. 
Bde 
58. 
597 


. def settingUp(): 

global stillTime, status, playTime 

checkSensors() 

showLEDs() 

if stillTime == 
stillTime = time.time() 

elif time.time() - stillTime > startDelay : 
status = running 
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60. playTime = time.time() 1277 pygame.draw.rect(screen, ( 
61. pygame.mixer.music.unpause() b,b,b), (0,0, 300,100) ,@) 
62. #"play music - game running" 128. screen.blit(messages[m],(@,®)) >PYTHON 
63. displayMessage(2,128) 1297 pygame.display.update() 
64. if leftMovement or rightMovement: 130. DOWNLOAD: 
65. stillTime = @ 131. def checkSensors(): magpi.cc/1NqJjmV 
# reset the still time before the music 1325 global 

66. moveSound.play() leftMovement , rightMovement PROJECT 
67. displayMessage(1, random. randint (40, 220) ) 133) if io.digitalRead(pirPins[®]) VIDEOS 
68. == 1 and not(leftMovement) : 
69. def gameRun(): 134. leftMovement = True Check out Mike's 
70. global leftMovement,rightMovement, status, playTime 1353 elif io.digitalRead( Bakery videos at: 
TA checkSensors() pirPins[@]) == @ and leftMovement: magpi.ce/4NqJnTz 
725 showLEDs () 136. leftMovement = False 
73% if time.time()-playTime > playDuration : 137 if io.digitalRead( 
74. #"music stops" pirPins[1]) == 1 and not(rightMovement) : 
75h displayMessage(3,128) 138. rightMovement = True 
76. pygame.mixer.music.pause() 139% elif io.digitalRead(pirPins[1]) == ð and rightMovement: 
TIR status = winner 140. rightMovement = False 
78. playTime = time.time() 141. 
TAN else : 142. def showLEDs(): 
80. if not pygame.mixer.music.get_busy() : 143. if leftMovement : 

# check end of music file 144. io.digitalWrite(ledPins[0],®) # turn Red on 
81. pygame.mixer.music.rewind() 145. io.digitalWrite(ledPins[1],1) # turn Green off 
82. pygame .mixer.music.play() 146. else: 
83i 147: io.digitalWrite(ledPins[@],1) # turn Red off 
84. def gameWinner(): 148. io.digitalWrite(ledPins[1],@) # turn Green on 
85. global leftMovement,rightMovement, status 149. if rightMovement : 
86. if time.time() - playTime > stopDelay : 150: io.digitalWrite(ledPins[2],©) # turn Red on 
87. checkSensors() 151% io.digitalWrite(ledPins[3],1) # turn Green off 
88. showLEDs() 1525 else : 
89. if leftMovement or rightMovement : 153; io.digitalwrite(ledPins[2],1) # turn Red off 
90. moveSound.play() 154. io.digitalWrite(ledPins[3],®) # turn Green on 
Calz if leftMovement : 155; 
92% print"right player wins" 156. def initGPIO(): 
93% winLED(1) 157; global ledPins,pirPins 
94. displayMessage(5,128) 158. ledPins = [ 4,17,27,22] # left R, left G, right R, right G 
OS else : 159. pirPins = [18,23] # left / right 
967 print"left player wins" 160. Ey: 
CMe winLED(@) 1617 io.wiringPiSetupGpio() 
98. displayMessage(4,128) 162. except : 
99% status = rstart 163; print"start IDLE with 'gksudo idle' from command line" 
100. time.sleep(3.5) 164. os._exit(1) 
Tor: 1657 for pin in range (0,4): 
102. def gameRstart(): 166. io.pinMode(ledPins[pin],1) # led pin to output 
103. global restart, status, stillTime, playDuration 167; io.digitalWrite(ledPins[pin],1) # turn off 
104. if restart : 168. io.pinMode(pirPins[9],©) # input left PIR sensor 
105. restart = False 169. io.pinMode(pirPins[1],@) # input right PIR sensor 
106. status = setup 170. io.pullUpDnControl(pirPins[@],2) # input enable pull up 
lOve checkSensors() 17i io.pullUpDnControl(pirPins[1],2) # input enable pull up 
108. showLEDs () 17A 
109. displayMessage(@,128) 173. def terminate(): # close down the program 
110. print"ready" 174. print"closing down" 
a stillTime = 0.0 175: pygame.mixer.quit() 
LAD playDuration = random.randint(6,20)+6 1763 pygame.quit() # close pygame 

# time till next stop IR os._exit(1) 
ala eke else : 178. 
114. displayMessage(6,128) 179. def checkForEvent(): # see if we need to quit 
T5: 180. global restart 
116. def winLED(player): 181. event = pygame.event.poll() 
H7 for i in range(0,4): # all LEDs off 182. if event.type == pygame.QUIT : 
118. io.digitalWrite(ledPins[i],1) 183. terminate() 
119. if player == @: # winner's LEDs yellow 184. if event.type == pygame.KEYDOWN : 
120. io.digitalwrite(ledPins[9], ð) 185. if event.key == pygame.K_ESCAPE : 
1217 io.digitalWrite(ledPins[1],0) 186. terminate() 
122. else : 187. if event.key == pygame.K_SPACE : 
123. io.digitalwrite(ledPins[2], 9) 188. restart = True 
124. io.digitalWrite(ledPins[3],2) 189. 
1257 190. if _name_ == '_main_': 
126. def displayMessage(m,b): 191 main() 
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Tutorial 


WESLEY ARCHER 


Self-taught Raspberry Pi enthusiast, 
founder of Raspberry Coulis, and 
guide writer for Pi Supply and Cyntech. 
raspberrycoulis.co.uk 
@RaspberryCoulis 


SOFTWARE 


In the final part of our build, we’ll be getting the software 
working so you can start playing with your RaspCade! 


The Raspesde booting up, whilst ow that we have finally assembled our 
displaying our custom splash screen RaspCade, the last part of this build is to get the 
software up and running so that we can start 


playing retro video games to our heart’s content! Today, 
\ we’ ll be looking at how to install RetroPie, configuring 


your controls, adding your games, and any other tweaks 
to get the most out of our RaspCade so that you can play 
your favourite games whenever you feel like it! 


Download RetroPie 
| RetroPie plays a key part in our RaspCade, so head over 
to their website (magpi.cc/25UDXzh) and download 
the SD card image. Be sure to download the correct 
one for the Pi model that you’re using, although we do 
recommend using the Pi 3 for this to get the most out 
of your RaspCade. For those of you who are unfamiliar 

with RetroPie, it’s a fantastic piece of software that 
runs various video game emulators, but all within 

a beautiful user interface that closely matches 
today’s generation of consoles. It’s actively 
developed, and updates are pretty regular! 


> Class 10 micro 
SD card (16GB : g / . 
upwards in Suis / Write your SD card 


recommended) a / Now you have your SD card image, you can write 
> RetroPie \ this to your SD card using your preferred software. 


magpi.cc/ ‘ r y- Check out Raspberry Pi’s official documentation on 
25UDXzh ' 


how to do this (magpi.cc/1V50j8E). We do recommend 

> USB flash investing in a quality SD card here; a Class 10 card is 

arive (opt nel) essential, as it will provide fast read and write speeds. 
> Our custom The card will also need a decent amount of storage 

splash screen This USB port makes ‘ A 

PETA adding new game space if you want to store your ROMs on it; we would 

2dFLRQN ROMs a breeze! recommend at least 16GB of space for this, but up to 

32GB is supported. 
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CED, So SUPERNINTENDD 


30 GAMES AVAILABLE 


IJU NINTENDO 


a MNU O StU È 


Boot your RaspCade 

Once your SD card has been prepared, it’s now time 
to pop this into your Pi and boot up your RaspCade! 
All being well, you should see the RetroPie logo 

as your RaspCade boots. You can use our custom 
RaspCade splash screen (magpi.cc/2dFLR9N) if you 
like and we’ll cover how to change this shortly. The 
first boot usually takes a little longer than normal, as 
the file system will be expanded to fill your SD card, 
but you’!l know when it’s done when you see the 
welcome screen. 


Setting up your controls 

Fortunately, RetroPie makes setting up your controls a 
simple process; you’re asked to do this during the first 
boot. You should now see the welcome screen asking 
you to hold a button on your device to configure it. 
Press and hold one of the buttons on your RaspCade 


Whilst not in this guide for simplicity, putting NeoPixels 
inside the buttons adds some pizazz to the RaspCade 
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and then follow the on-screen prompts, pressing 
the relevant buttons when needed. You can skip 
assigning a button by holding any button until the 
tutorial moves on. All being well, you should be able 
to assign directions to your joystick, as well as the 
eight arcade buttons. 


Transferring your ROMs 

ROMs, short for Read-Only Memory, are the game 
files. These are basically a collection of the files 
you'd find on a game cartridge if you took the 
data straight off them, and yov’l need them play 
certain games on your RaspCade. The quickest 
way of transferring the ROMs to your RaspCade is 
by following the USB guide on RetroPie’s website 
(magpi.cc/2dmE14h), as this will automatically 
transfer all the files to the correct place without any 
major user input. You can use the USB port on the 
front of the RaspCade to do this, too! 


Restart and play! 

Once you have added all your ROMs, you need to 
restart your RaspCade so that RetroPie can load 
them. You should notice that different gaming 
systems will appear after you have rebooted, 
mirroring those that you’ve added. Now you can 
simply pick your system, choose your favourite 
game, and start playing on your very own RaspCade! 
You may need to tweak a few more settings, such as 
the display and controls for different systems, but 
we recommend getting to know the RetroPie wiki 
page (magpi.cc/2emU7fV) as there’s a wealth of 
information there. 


Tutorial 


We highly 
recommend using 
Pimoroni's Picade 


PCB as it takes the 
hassle out of your 
controls and sound 


-a definite must! 


CUSTOM 
RASPCADE 


SPLASH 
SCREEN 


ROMS 
ON USB 


INSTEAD 
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> Pi Cap and 
Electric Paint 
magpi.cc/ 
2ze8kmGK 


> micro-USB cable 
> Pi power supply 
> Crocodile clips 


> Acrylic 


> Glue 


> Cardboard 


> Aluminium foil 


CROCODILE 
CLIPS 


GING 


ONK 


PAUL TANNER, 
ROSS ATKIN 
& TINA ASPIALA 


Paul, Ross, and Tina are loT developers, 
engineers, and designers. They enjoy 
testing the limits of the latest tech with 
Bare Conductive. 

magpi.cc/2dDDdXP / @BareConductive 


Four of the Pi Cap’s 12 
capacitive electrodes 
are being used as 
proximity sensors 


The game runs on a Pi Zero 
with a Pi Cap add-on and 
Ethernet cable 


Players move their hands 
between the Electric Paint 
sensors to control the 
paddles on screen 


A PONG GAME 


Make a physical version of Pong! Use capacitive sensing and Electric Paint 
to make a fun and addictive two-player game to play with your friends 


apong breaks Pong out of the screen and 

into your hands. Map the Pong paddles to 

the position of your hands, using a Pi Cap 
and Raspberry Pi, to create a simple and addictive 
game. Capong is a physical reinterpretation of the 
original video game. Instead of mouse or arrow keys, 
it uses sensors arranged on a laser-cut stand so 
that each player moves her hand between a pair of 
sensors. The game is based on SimplePong, available 
on openprocessing.org and released under Creative 
Commons. It was modified to use input from the Pi Cap 
sensors and converted to two-player operation. 


First steps 

First, we need to set up the Pi Cap. Run through the 
‘Setting up your Pi Cap on the Raspberry Pi Zero’ 
tutorial found at magpi.cc/2emLB1K, and don’t miss 
any steps. (You need to know the IP of the Pi to log 
into it.) Run through the Pi Cap intro to see the code 
examples, particularly the one that streams the sensor 
data via OSC to your laptop terminal window. Notice 
the DIFF data; that’s what we’ll be using. 
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Once you’ve done this, download and install 
Processing if that’s not already on your laptop. Unzip 
and install the code mpr121_pong in Processing’s 
sketch folder, usually /Documents/Processing. Open 
the sketch in Processing and start it running. To run 
the OSC demo standalone, go to your PiCapExamples 
folder on the Pi and cd to cpp/picap-datastream- 
osc-cpp. Use ./run to see the Pi Cap datastream. Find 
out the IP of your laptop then use ./run -host [IP 
address of laptop] to stream it to Processing. Pong 
should now be running. Click the laptop mouse to 
start a game; it finishes when a player misses the ball. 
Click the laptop mouse to start another game. 

If you want to build the acrylic stand, as seen in our 
version, you can download the Illustrator files online 
(here: magpi.cc/2enaB7V and here: magpi.cc/2enc6Tn) 
and follow the tutorial instructions, courtesy of 
@rossatkin. You will need a laser cutter to cut these out, 
or you can make it out of foam board. 

To assemble your stand, glue one of the I-shaped 
pieces of acrylic to the white rectangular piece with 
no holes in it. 
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To build the acrylic stand seen here, you 
can download the Illustrator files online 


Before you glue 


in the two red rectangular pieces, 


make sure to insert two of the crocodile clips inside 
the structure; there should be a slot for the cables 
to exit when you attach the sides. This will ensure 
the wires are concealed within your stand, but 


still accessible. 


Glue the two red rectangular pieces to the white 


structure. Using a 


small paintbrush, dab all the joints of 


the stand with the acrylic glue; this adhesive will melt 
the plastic pieces together. Careful with the red acrylic: 


it may melt andre 


lease some colour. You should still 


have one acrylic piece remaining: the white rectangle 


with two holes. Don’t glue this piece on yet. 


Stand your Capong upright, so the white piece with 


no holes is touchi 
enough wire so th 
the top; you need 


as shown in the pi 


Now, leave som 


ng the tabletop. Make sure you have 
at your crocodile clips protrude at 
at least 7.5cm of croc clip visible, 
cture. 

e length of the wire out the 


bottom of the stand, and cut and strip the wire. You 


should have abou 


t 1.5cm of copper wire protruding. 


You’re going to use this to attach the copper wire 


to the sensors. 


Cut out two cardboard squares and two rectangles. 
These will go on your stand so you can measure the 
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CAPONG - A PONG GAME 


RED 
ACRYLIC 


Careful when 


gluing the 
red acrylic - 
it may melt 
and release 
some colour. 


Left Be patient 
with the build and 
you'll get there 


Bottom left 
You may need 
to shorten 
your crocodile 
clips during 
construction 


STRAIN 
RELIEF 


Secure each 
cable on its 


sensor so 


they don't 
move (you can 
use double- 
sided tape). 
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Tutorial = WALKTHROUGH 


Above top Paint 
Electric Paint to 
make your sensor, 
and to cold- 
solder to your 
crocodile clip 


Above Attach 
each of the 

four crocodile 
clips from each 
sensor to the 
correct electrode 


TROUBLE- 
SHOOTING 


Make sure 
you've 


mapped 
the correct 


crocodile clip 
to each sensor 
and electrode 
combination. 


size of the interior surfaces. If you’re using Electric 
Paint, you can paint directly onto these squares. 

Once dry, apply some double-sided tape; you’re 
going to glue the sensors face down against the 
acrylic. But first, you must cold-solder the paint! 

Using your Electric Paint tube, squeeze out 
a generous amount of paint onto the exposed 
copper. You should make sure the wire is held 
in place so that it doesn’t move around; you can 
use double-sided tape. When you’ re finished, 
you should have four sensors — two square, two 
rectangular — connected to each of the sides of the 
Capong stand. 

If you don’t have Electric Paint, you can 
make your sensors using aluminium foil. Just 
follow the same steps as above, but sandwich 
the exposed wire between the aluminium foil 
and the cardboard. 

You can now firmly attach your sensors to the 
stand and get out your Pi Cap and Pi Zero. Take the 
crocodile clips that are protruding from the top of 
the Capong stand and attach them to your Pi Cap’s 
electrodes. Make sure you’re connecting to the 
correct electrodes, the ones you’ve programmed 
for functionality. 

Now you can connect your Pi Zero, upload the 
code, and get playing! 
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mpr121_pong.pde 


or: 
9027 
03. 
04. 
05: 
06. 
07. 
08. 
09. 
10. 
T 
T25 
13. 
14. 
15. 
16. 
17. 
18. 
19% 
20. 
Dake 
227 
23%. 
24. 
2010 
26. 
2h. 
28. 
29. 
30. 
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325 
39; 
34. 
395. 
367 
Bl 
38. 
395 
40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
507 
ils 


52 
52. 


import oscP5.*; 

import netP5.*; 

final int numElectrodes = 12; 
boolean serialSelected = false; 
boolean oscSelected = false; 
boolean firstRead = true; 
boolean soloMode = false; 
boolean gameStart = false; //true; 
float x =1150; 

float y = 150; 

float speedX = random(3, 5); 


float speedY = random(3, 5); 
int leftColor = 128; 

int rightColor = 128; 

int diam; 

int rectSize = 150; 

float diamHit; 

int vpos1 = @; 

int vpos2 = @; 


OscP5 oscP5; 
int[] diffs; 
int globalGraphPtr 
int electrodeNumber 


int serialNumber 
int lastMillis 


tS an 
OQ FOO 
we Ge we 


we 


void setup() { 
size(500, 500); 
noStroke() ; 
smooth(); 


// setup OSC receiver on port 3000 
oscP5 = new OscP5(this, 3000); 


// other setup 
diffs = new int[numElectrodes]; 


void oscEvent(OscMessage oscMessage) { 
println("oscevent"); 


if (firstRead && oscMessage. 
checkAddrPattern("/diff")) { 
firstRead = false; 


} 


else { 
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CAPONG - A PONG GAME 


54. if (oscMessage.checkAddrPattern("/diff")) { 195. diamHit = random(75,150); 
55. // simulate mouse in original game 106. ellipse(x,y,diamHit >PROCESSING 
56. updateArrayOSC(diffs, oscMessage. ,diamHit) ; 
57. arguments()); 107. rectSize = rectSize-10; DOWNLOAD: 
vpos1=diffs[10]-diffs[1]+100; // guesswork 108. rectSize = magpicczdpE4bO 

58. vpos1*=2.5; constrain(rectSize, 10,150); 
59. if (vpos1 > 450) vpos1=450; // limits 109. } 
60. if (vpos1 < 80) vpos1=80; 110. 
61. vpos2=diffs[0]-diffs[11]+100; // guesswork dakka // if ball hits wall, change direction of X 
62. vpos2*=2.0; (single-player only) 
637 if (vpos2 > 450) vpos2=450; // limits 1127 else if (false && x < 25) { 
64. if (vpos2 < 80) vpos2=80; Ilea speedX = speedX * -1.1; 
65. print(vpos1, vpos2) ; 114. x = X + speedX; 
66. println(); JHS leftColor = 0; 
67. } 116. } 
68 } 117 
69. } 118. else { 
70. 119. leftGolor = 128; 
71. void draw() { 120. rightColor = 128; 
T2 background (255); 1217 } 
TiS} 122 
74. £i11(200,0,0); 1237 // resets things if ball hits either wall - you lose 
xe diam = 20; 124. if (x > width || x < 0) { 
76. ellipse(x, y, diam, diam); 125. gameStart = false; 
Wh 126. //delay(500@0); // auto-restart 
78. £111(200,0,0); T27: //gameStart = true; 
79. rect(width-30, vpos1-rectSize/2, 10, rectSize); 128. Xe 150: 
80. rect(30, vpos2-rectSize/2, 10, rectSize); 129. Ve= 1565 
81. 130. speedX = random(3, 5); 
82. if (gameStart) { T31: speedY = random(3, 5); 
83. 1325 rectSize = 150; 
84. xX = X + speedX; 1335 } 
85. y = y + speedY; 134. 
86. 135: // if ball hits up or down, change direction of Y 
87. // if ball hits movable bar, invert X 136. if ( y > height || y<@) { 

direction and apply effects 137: speedY = speedY * -1; 
88. if ( x > width-30 && x < width-20 && y > 138. y = y + Speedy; 

vposi-rectSize/2 && y < 139. } 
vposi+rectSize/2 ) { 140. } 

89. speedX = speedX * -1; Ales), 
90. x = X + speedX; 142. 
oT: rightColor = @; 143. void mousePressed() { 
92. £i11(200,0,0); 144. gameStart = !gameStart; 
93. diamHit = random(75,15@); AS ian}, 
94. ellipse(x,y,diamHit, diamHit) ; 146. 
95. rectSize = rectSize-10; 147. void updateArrayOSC(int[] array, Object[] data) { 
96. rectSize = constrain(rectSize, 10,150); 148. if (array == null || data == null) { 
97. } 149. return; 
98. 150. } 
99 // similar if ball hits the other movable bar 151. 

(2 players) 1527 for (int i = 0; i < min(array.length, 
100. else if ( x > 20 && x < 30 && y > vpos2- data.length); i++) { 

rectSize/2 && y < vpos2+rectSize/2 ) { 153: array[i] = (int)data[i]; 
101. speedX = speedX * -1; 154. } 
102. x = X + SpeedX; 1557 
103. rightColor = ð; 156. 
104. £i11(200,0,0); 157 
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USB TV tuner 
linuxtv.org/wiki 


USB remote 
control 
magpi.cc/ 
2dDLriE 


USB hard disk 
magpi.cc/ 
2dDLN8F 


Powered 
USB hub 
magpi.cc/ 
2dDLFGh 


OSMC 
osmc.tv 


MPEG2 codec 
magpi.cc/ 
2dDLToc 


PIVR 


A PI-POWERED PVR 


Make your own PVR to record and watch live TV, 
as well as stream video and audio 


arou 
a PV. 


he secular festival of Good Telly Season is just 
nd the corner, so what better time to make 
R that does everything? From recording 


TV shows to streaming favourite films from your NAS 


to playing tu 
everything a 
misleading li 


nes f 


Better stil 


requires a few fairly basic terminal comma 


, you 


running. There’s 


plenty to please the experts. 


part from vi 
ke that. 


rom your smartphone, a 


r PiVR only uses USB dev 


nothing here to scare a Pi 


PiVR can do 


rtual reality: the name’s a little 


ces and 
nds to get 
novice, and 


The PiVR is based around a Pi 3, both for its 


processing power and t 
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he current it can feed to USB 


devices. The TV tuner 


We used a 3A powered 
USB hub to prevent 
brownouts when 
watching telly 


The Pi 3 provides 
enough juice to power 
the TV tuner directly; 
older Pis would struggle 


You could house the PiVR 
in an old set-top box, or 
build your own case 


used in this project can be 


found here: magpi.cc/2dDMTS7. However, with this 
TV tuner taking up to 500mA, an old laptop hard disk 


sucking 1A and the Pi i 


tself consuming up to 800mA, 


we worried about brownouts if we powered everything 
from the Pi. We therefore based our project arounda 


3A powered USB hub: 


plenty of headroom. 


OSMC and the software 

We chose OSMC (osmc.tv) as the basis for the PiTV, 
as it incorporates the popular Kodi front-end (albeit 
in skinned form) with a full Raspbian back-end. 
Essentially, it’s easy to use and easy to modify and 
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add to. Better yet, it’s a cinch to install: download the 
installer and itll set up your SD card automatically. 
You can even enter your WiFi details during the install 
so the Pi is ready to go once it’s booted. 

Update OSMC and its apps in the usual way, over 
SSH. The login credentials are osmc/osmc: change 
these as soon as possible via the passwd command. 


sudo apt-get update && sudo apt-get -y upgrade 


If your hard disk has also lived a former life, wipe 
and format it with fdisk and then reboot. 


fdisk /dev/sda 


Next, mount the hard disk and link it to a folder 
called recordings: 


sudo 
sudo 
sudo 
sudo 
sudo 


mkfs.ext4 /dev/sda -L storage 
mkdir /mnt/recordings 

mount /dev/sda /mnt/recordings 
chown osmc:osmc /mnt/recordings 
chmod 777 /mnt/recordings 


Now you can find your Pi’s serial number, which 
is needed to buy an MPEG-2 codec licence for your 
Pi (this licence will be tethered to your Pi). Without 
an MPEG-2 codec licence, the Pi will have to decode 
the TV signal in software rather than its bespoke 
hardware, which can lead to overheating and general 
performance issues. Follow the instructions at 
magpi.cc/2dDLToc and pay the £2.40. Your licence 
code should arrive within 72 hours; add the entire line 
of the received MPEG~-2 licence to your config file: 


sudo nano /boot/config. txt 


Getting your TV tuner up and running might require 
some detective work, but your first step is to find 
your tuner on magpi.cc/2dDNsLv. If you’re lucky, 
your tuner won’t require specific firmware, otherwise 
you'll have to download it, typically from GitHub: see 
magpi.cc/2dDMIg9h. However, our PCTV TripleStick 
(292e) required even newer firmware, which we found 
at magpi.cc/2dDMiQm: 


wget http://palosaari.fi/linux/v41-dvb/ 

firmware/Si2168/Si2168-B40/4.0.25/dvb-demod- 
Si2168-b40-01. fw 

sudo mv dvb-demod-si2168-b40-01.fw /lib/firmware 

sudo reboot 

dmesg 


The return from dmesg shouldn’t list any errors 
regarding firmware not downloading. If so, you can 
proceed to setting up Tvheadend, the server and 
client combination that handles all the live TV duties 
for the PiVR. 
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PIVR 


Tutorial 


g Live TV 


OSMC itself is attractive and easy to use; it ll 
work with most USB remote controls, too 


Tvheadend on OSMC 


The easiest way to install the latest, correct version of 
Tvheadend is via OSMC’s front-end. First, you must 
navigate its awkward setup procedure; use onlya 
keyboard, as it’s too easy to get confused as to which 
level of menu or option you’re selecting with a mouse. 
Once negotiated, head to My OSMC and track across 
to Remotes to set up your remote. Then track back to 
the OSMC Store and install Tvheadend (it’s free, don’t 
worry), not forgetting to select Apply to actually start 
the installation. 

Once installed, you’ll need to switch to another 
computer to set up Tvheadend; point a browser to 
http://<pi-ip-address>:9981 and log in with 
osmc/osmc. Now follow this setup order to avoid 
getting into awful tangles with Tvheadend. First, 
head to Configuration > DVB Inputs > Networks. 
Click Add and then choose DVB-T as the Type; on the 
next screen give your ‘network’ a relevant name and 
select the correct Predefined Mux for your TV area (see 
digitaluk.co.uk if you’re not sure). If you’re on the 
edge of two masts’ coverage, add a network for both. 
Now go to the TV adapters tab and select your TV 
tuner; on the right-hand pane, tick the Enabled box 
and add any and all networks via the Networks field. 
Head to the Muxes tab and you should see many 
entries with a scan status of PEND; after a while, these 
will switch to Active, and hopefully then to OK. The 
last job in the Tvheadend webpage is to head to the 
Recording tab and change the recording location to 
your hard disk, in our case mnt/recordings. Click Save 
which is toward the top-left for this section. 

Now you can switch back to OSMC on your Pi. Head 
to Settings > Add-ons > My add ons > PVR clients > 
Tvheadend HTSP Client. Press Enter on your remote, 
then select Configure. Enter the Tvheadend login 
details (osmc/osmc) and then select Enable. Finally, 
head to Settings > TV > General and tick Enabled; you 
should see OSMC update a few things. Head back to 
the main OSMC menu and you’! now see an option for 
Live TV. Open that, and you’!l see an EPG and other 
such options. To watch a show, select it from the 

EPG and then press Back on your remote until you go 
‘beyond’ the main menu into full-screen live TV. 


NEATER 
BUILD 


Using a 314GB 
WD PiDrive 
(which only 
consumes 
0.55A) might 
allow you to 
drop the USB 
hub from 

the build. 


AUDIO 
ADD-ON 


OSMC 
supports 
AirPlay (from 
iTunes servers) 
while the Pi 3 
has Bluetooth 
- upgrade the 
audio output 
and you've got 
a streaming 
jukebox. 


SCREEN OUT 


Add a VFD 
display for 


extra slickness, 


perhaps using 
a £10 ZeroSeg 
with the two 
buttons left off 
(magpi.cc/ 
2dOtGBg). 
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IRIM ME YOUR QUESTIONS ANSWERED 
NEED A 
PROBLEM 


FREQUENTLY pan 
ASKED QUESTIONS Erm 


to feature in a future issue. 


— 
RASPBERRY PI = 


Sensors 

The Sense HAT is one of the most famous HATs; as 
well as adding a big LED matrix, it has extra sensors. 
This allows the Raspberry Pi to use humidity, 
temperature, and other measurements in programs. 
More inputs 


Your technical hardware and software problems solved... 


Some HATs can add extra buttons or input devices to 
the Raspberry Pi. The Skywriter HAT allows for motion 
controls, while the Piano HAT has capacitive piano 
keys you can use to create a symphony. 


Add-on 

A HAT is a type of add-on for the Raspberry Pi Extra ports 

that connects to the GPIO pins and gives it further Not quite as common are HATs that add extra 
functionality. There’s a specific definition that takes connectivity to the Pi. This can be alternate wireless 
into account size and other factors, but that’s the or wired internet connections, extra USB ports, or 
major part you need to know. even motor controllers to plug robot parts into the 


Raspberry Pi easily. 
Hardware Attached on Top 


HAT is an acronym (or possibly a backronym) of 
Hardware Attached on Top, as the hardware add-on is 
attached on top of the Raspberry Pi. Smaller HATs are 


sometimes called pHATs and are usually designed with Official HATs 


the Pi Zero in mind. The Sense HAT is currently the only HAT officially 
made by Raspberry Pi; you can get it from a few 
Other add-ons places such as Pimoroni, Elementi4, and other 
Below The Sense There are other add-ons for the Raspberry Pi that official suppliers. Check out the page for it on 
HAT is the official aren’t called HATs; usually, they don’t meet the ‘HAT’ the Raspberry Pi website for more information: 
ee specification mentioned earlier, but they’re no less magpi.cc/1TGGUt5 


Astro Pi mission capable of giving extra functionality to the Raspberry Pi. 


Unofficial HATs 

These can be made by anyone and you’ ll find them 
either on general Raspberry Pi online stores for the 
more generic ones, or on specialist sites for the more 
niche varieties. Just because they’re not made by Pi, 
though, doesn’t make them any less of a HAT. 


Make your own HAT 

If there’s a specific function you want to add to your 
Raspberry Pi, why not create your own special HAT? 
We did a tutorial on this in issue 42 of The MagPi 
(which you can find here: magpi.cc/Issue-42), 

so give it a look. 
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What is the Camera Module? 

The Camera Module is a small PCB that connects to the 
CSI-2 camera port on the Raspberry Pi using a short ribbon 
cable. It provides connectivity for a camera capable of 
capturing still images or video recordings. The camera 
connects to the Image System Pipeline (ISP) in the 
Raspberry Pi's SoC, where the incoming camera data is 
processed and eventually converted to an image or video 
on the SD card (or other storage). You can read more about 
the Camera Module here: magpi.cc/28ljlsz. 


What model of camera does the Camera Module use? 
The Camera Module V2 is a Sony IMX219, while the 
original Camera Module is an Omnivision 5647. They are 
comparable to cameras used in mobile phones. 


What resolutions are supported? 

The Camera Module V2 is capable of taking photos up 
to 8 megapixels (8MP). It supports 1080p30, 720p60 and 
VGAQ0 video modes, as well as still capture. The original 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered: 


How do I find The MagPi on Google Play or the App Store? 
Allyou have to do is go to the search bar and type ‘The MagPi’ 


or ‘Raspberry Pi’ to find us. 


I've subscribed to the digital edition and I can't sign 
in to restore my purchases. Please help! 


Camera Module is capable of taking photos up to 5 megapixels 
and can record video at resolutions up to 1080p30. 


Which picture formats are supported? 

The Camera Module supports raw capturing (Bayer data direct from 
the sensor) or encoding as JPEG, PNG, GIF, BMP, uncompressed 
YUV, and uncompressed RGB photos. It can record video as H.264, 
baseline, main, and high-profile formats. 


How do I use the camera? 

There are three command-line applications provided for stills, 
video, and stills output uncompressed. These applications provide 
the typical features you might find on a compact camera, such as 
set image size, compression quality, exposure mode, and ISO. See 
the documentation for more details: magpi.cc/2egdAQA. 


Can I extend the ribbon cable? 

Yes. We have reports of people using cables up to 4 metres long 
and still receiving acceptable images, though your experience 
may differ. 
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GREATEST 
PROJECTS 


Since your The MagPi purchases are linked to your Google or 


Apple accounts, there's no need to sign in at all. If you'd like to 


re-download your purchases on your current device, or make your 


purchases available on other devices, all you need to do is press 


‘Subscribe’ on the home screen, then ‘Restore Purchases’ on the 


next screen. 


How can I search the digital magazine for keywords? 


GET IT ON 


P> Google Play 


Finding direct references is really easy with The MagPi app: all you 
have to do is tap the screen to get the app's GUI to show, and then 4 Available on the 


€ App Store 


press the small magnifying glass icon in the top-right corner of the 


screen. Just type in your search term to find the relevant results. 
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PROJECTS MADE EASY 
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Can you survive a walk in the 
woods and avoid all the nasty 
skeletons in this Scratch game? 


72 


Create a nasty surprise for 
anyone with this motion- 
activated screaming Pi. 


74 


Don’t waste candles: create a 
spooky, electric-powered 
jack-o’-lantern instead. | 
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\ 


ROB ZWETSLOOT 


ou should always be careful when walking 

i | Y through the woods around Halloween; what if 

Yj a scary skeleton has a bone to pick with you? 

i In this tutorial we’re making a simple game in Scratch, 
i where you have to dodge the skeletons by pressing 

the left or right arrow on your keyboard in time. We’re 
making this in Scratch 2.0 in the new Raspbian with 
PIXEL Chromium browser; refer to the tutorial starting 
on page 46 for how to get it ready. 


when leftarrow key pressed FIG-01 


en ates | 


set skeleton location 


E o | 


set skeleton_trigger to f 


when space key pressed 


forever 


‘wait ŒB secs 


wait (o.s ] secs 


when space key pressed | 


“skeleton location = g 


set skeleton_trigger — 


b 
wait (o.s } secs 


Tinkerer, sometime maker, 

other-times cosplayer, and 

all-the-time features editor 
of The MagPi. 

| magpi.cc / @TheMagP1 


Create a spooky Scratch game and dodge those nasty skellies 


>STEP-01 

Get some sprites 

We’ve already pre-prepared some sprites that you can 
use for this artful game of bone avoidance, which you 
can find here: magpi.cc/SkeleDodger. 

This includes an animated skeleton sprite, a 
pointer to warn you which direction a skeleton will 
come from, and a forest background. These were all 
obtained from OpenGameArt.org, an amazing place to 
get free graphics and sounds for your games. 

Go to scratch.mit.edu, start a new project, and click 
on ‘Upload backdrop from file’ to upload the forest 
background. We also then moved the cat so it looked 
like it was walking along the ground. 


>STEP-02 

Different costumes 

Load the skele1 sprite into Scratch by clicking on 
‘Upload sprite from file’ in the Sprites box. Place him 
on the left side of the screen for now. Click on the 
Costumes tab and click on the ‘Upload costume from 
file’ icon to upload the rest of the skeleton sprites. 
Once you’ve done that, click ‘Paint new costume’ 

to add one more sprite to the skeleton. Don’t make 
anything; just save it and name it skeleo. This allows 
us to have the skeleton disappear! Now, upload the 
pointer sprite in the same way, and create a blank 
costume for it so we can have it blink. 


>STEP-03 

Cat code 

See Fig-01 for how we’re coding the cat. When the 
green flag is pressed, the game is reset and the cat 
asks you to press the space bar to play. Pressing 
SPACE stops the cat’s message, then starts a looping 
walking cycle using its second costume. SPACE also 


a 


I I 

© A spooky forest @ The cat is you, walking 
background for our through the forest, not 
very spooky game a care in the world 


>STEP-04 


>STEP-05 
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I 

I 

© The skeletons are out to get 
you! You'll get a warning 
where they're coming from 


when g dicked 


r 


magpi.cc/SkeleDodger 


>STEP-06 


l 
| Scratch 2.0 
J 
I 
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CREATE A 


Wilhelm Scream 

audio file H 
magpi.cc/ 

2diLoex 


HC-SR501 PIR 
sensor 
magpi.cc/ 
2diJivg 

Mini portable 
speaker 


magpi.cc/ 
2diQyHq 


Breadboard and 
jumper wires 


Connect the PIR 
sensor's OUT cable 
to GPIO pin 4. This pin 
is used in Python to 
detect motion and 
activate the scream 


The PIR sensor has 
three connections: 
live, ground, anda 
switch to connect to 
send a signal to the 
Raspberry Pi when it 
detects movement 
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ceoerererede 


>STEP-01 
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scream.py 


gpiozero MotionSensor 
time 
pygame 


pygame.mixer.init() 
pygame.mixer.music.load( 


pir = MotionSensor (4) 
pir.wait_for_no_motion() 
True: 


( ) 


pir.wait_for_motion() 


( ) 
pygame.mixer.music.play() 
time.sleep(3) 


>STEP-02 


>STEP-03 


>STEP-04 
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>STEP-05 


>STEP-06 


Witha 


portable charger 
it's possible 

to embed the 
Raspberry Pi inside 
a pumpkin. Just 
make sure the 

PIR sensor can 
view the outside. 
(image: Daryl 
Mitchel, Flickr) 


Python 
magpi.cc/2dA5G1K 
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=. 


ELECTRIC-POWERED 


LED (orange p 
or red works) 


Resistor 
(400Q) 


Wires and such 
(jumpers will do) 


Carved pumpkin 
(scary) 


You could go fora 
classic, scary pumpkin 
like here but you 
could also make a 
special pattern 


It's a very simple circuit to build, 
you can test it on breadboard 
and then make the LED cable 
from the Pi 
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Poke the LED through 
the back; you probably 
don't want the whole 
Pi in there 


>STEP-01 
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>STEP-02 


>STEP-03 


>STEP-04 


>STEP-05 
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candle.py 


#!/usr/bin/env python 
RPi.GPIO GPIO 
time 

random randrange 


led_pin = 18 


GPIO.setmode(GPIO.BCM) 
GPIO.setup(led_pin, GPIO.OUT) 


led_pwm = GPIO.PWM(led_pin, 200) 
led_pwm.start(102) 
def ( ): 
led_pwm 
led_pwm. ChangeDutyCycle(change_brightness) 
def (): 
brightness(randrange(®, 100)) 


time.sleep(randrange(i, 10) * 0.01) 


True: 
flicker() 


>STEP-06 


Python 
magpi.cc/2dzF94P 
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Maker 
days 


Use your 


Raspberry 
Pi to take 
control of 
this string 


puppet 


Simon Monk 


PUPPET KIT FOR RASPBERRY PI 


PUPPET KIT FOR 
RASPBERRY PI 


Your Raspberry Pi pulls all the strings with this innovative puppet kit project 


MAPLIN 
ROBOTIC 
ARM 


Maplin’s robotic 
arm is amuch 
more complex 
build with more 
functionality. 

It can be 
controlled from 
a Raspberry Pi 


with Fuze BASIC. 


£50 / $61 
magpi.cc/2dLweuN 


he Puppet Kit by esteemed 

maker Simon Monk 

caught the attention 
of everybody at The MagPi. This 
quirky project has you detaching 
the strings from a traditional 
marionette and hooking them up 
to servo motors. These are then 
used with Python code to control 
the doll. 

“How cool,” said many team 
members; “Waah, clowns are 
creepy,” said even more. Maybe 
it’s Halloween coming, or the craze 
for dressing up as Killer Clowns 
on the news every night, but we 
certainly felt this puppet hada 
touch of Psychoville to it. 

A fear of psychotic circus 
performers has never stopped 
us from building before, and this 
doll’s creepy clown make-up isn't 
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going to stop us now. We quickly 
had ‘Mr Jelly’ out of his box and on 
the operating table. 

There’s a lot of promise in this 
build. With everything set up, you 
can make the puppet walk, wave, 
and even perform killer dance 
moves. You can get him to spot 
your wave and wave back, thanks 
to the included PIR sensor. 


Master of puppets 
The central part of the Puppet 
Kit is its four 9g servos to control 
the strings of the marionette. 
The strings are detached from 
the usual wooden cross and 
hooked up to little wooden 
arm extensions. 

A Servo Six board is wired 
directly to the GPIO pins on the 
Raspberry Pi (not included). Aside 


from the Pi and micro SD card, 
everything you need is in the box. 

Opening the kit reveals a 
plywood board, with holes 
marked for various components. 
To start the build, you screw 
in your Raspberry Pi and the 
Servo Six board to this plywood 
board. We found this first step 
the fiddliest part of the build, 
with each screw using a wooden 
washer and small nut. 

Then you move on to the 
battery box and servo motors. 
These are all attached using self- 
adhesive foam blocks, with the 
servos hanging over the edge 
of the plywood board. The idea 
is that you place the board on 
the edge of a desk or on top of 
a box, so that the puppet can 
dangle below. 
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PUPPET KIT FOR RASPBERRY PI 


‘A O IPON e 14 


haanadsoy 


The plywood board serves as a base for the project, 
with the Raspberry Pi and other components attached to it 


Everything is wired up using 
the ten female-to-female jumper 
cables. You connect the servos 
to the Servo Six board, and the 
latter directly to the Raspberry 
Pi. The instructions are clear and 
include a photograph for each 
step. It’s an ideal project for 
novice makers. 


GitHub. The instructions use Git 

to download (clone) the files. 
Attaching the puppet to the 

servos requires you to cut the 

strings. But if you’re careful, 

they can be easily reconnected 

to the wooden cross to give you 

back the original puppet. Then we 

hung the puppet over the edge of 


You can make the puppet walk, 
wave, and even perform killer 


dance moves 


We only had one slight hiccup 
during the build. We didn’t have 
the micro SD card inserted into 
the Pi when we started, and 
couldn’t access the card slot when 
it was time to test the servos (the 
position of the Servo Six board 
made it impossible to get in). So 
we had to remove the Pi, slot in 
the card, and reinsert it. So make 
sure you set up Raspbian Jessie 
with PIXEL before you get started. 


Puppet ona string 

The software side of things is easy 
thanks to Simon Monk’s Servo Six 
Python library, available from his 
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a desk and ran the test program. 
Our marionette sprang to life, just 
like Chucky from Child’s Play, and 
started to walk. 

With the build complete, you 
can head into the two projects. 
The first is an animation 
program where you use keyboard 
commands to control the puppet 
directly. The second project 
involves using the PIR sensor to 
detect motion. As you wave to the 
puppet, he waves back. 

Spending a day with the puppet 
was highly entertaining. It’s an 
ideal way to introduce young 
students to Raspberry Pi coding. 


A great project for novices that teaches the 
basics of servo motor control in a friendly 
environment. Not for the coulrophobes, though. 


Kkkk 
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Maker 


A handy, 
pocket-sized 


card of strong, 


meltable 


bioplastic 
FORMcard 


FORMCARD 


FORMCARD 


An eco-friendly plastic which softens in hot water, is FORMcard the future of making? 


SUGRU 
Mouldable by 
hand, Sugru 
transforms from 
a soft putty to 
flexible rubber 
overnight - but 
you can only 
use it once. 


ES 
& i) 


oe 


hen Peter Marigold’s 

FORMcard hit 

crowdfunding site 
Indiegogo, there was initial 
confusion: £5/S6 per pack for what 
appeared to be credit-card-sized 
lumps of plastic seemed a little 
over the top. Playing the video, 
though, revealed the FORMcard 
secret: it can be softened and 
worked by simply dunking it ina 
cup of hot water for a few seconds. 


Plastic fantastic 
Built from starch-based 
bioplastic, making it food- 
safe and biodegradable, each 
FORMcard represents a potential 
fix. Suggested projects range from 
building a compact screwdriver 
with a bare cross-head bit 
(FORMcard, surprisingly, having 
the strength to withstand such 
use), through to using it to encase 
electronics for waterproofing 
or repair broken casings 
on other devices. 

The standard FORMcard kit 
comes as a pack of three cards, 
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each the same size as a standard 
credit card though significantly 
thicker; you can choose from 

black, white, grey, or a mixture 

of colours. Its use couldn’t be 
simpler: just as in Peter’s video, 
you pour a cup of hot, clean water, 
submerge the FORMcard fora 
minute or so, then fish it out witha 
spoon and it’s ready to use. 

This is where things get, quite 
literally, sticky. Unlike rival Sugru, 
which is relatively easy to work 
while soft, FORMcard is extremely 
keen on retaining your fingerprints 
for all eternity, and hardens in 
minutes rather than the average 
24-hour curing time of Sugru. 


Reusable, remouldable 
Here, though, FORMcard’s second 
trick becomes apparent: it’s almost 
infinitely reusable. Unlike Sugru, 
which hardens permanently, 
FORMcard can be softened again 
by applying more heat. Actually 
removing the softened FORMcard 
from the surface to which it was 
applied is more of a challenge, 


admittedly, but it’s still a neat 
trick and one which allows for 
temporary repairs. 

FORMcards can also be combined, 
if you need more material for 
a particular project, and their 
shape allows you to keep one in 
your wallet for those just-in-case 
moments, assuming you can find 
a source of hot water, of course! 

In testing, the FORMcards 
became soft and workable at 
around 60°C; if you’re looking to 
house or repair anything which 
gets even near this temperature, 
you’ ll need to look elsewhere for 
the solution. 


{ast word 


Although not easy to work with 
and unsuitable for projects 
that get hot, FORMcard's 
strength, eco-friendly 


credentials, and reusability 
mean it should be a standard 
in every maker's toolbox. 
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NEOPIXEL 
RING 


Available in 
various sizes, 
from 12 to 60 
NeoPixels, 
these chainable 
rings are an 
alternative to 
the standard 
NeoPixel strips. 


From £6 / $8 
magpi.cc/2dXaWLy 
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MCROBOFACE 


| Maker 
says 
Add 
emotion and 
fun to your 
electronic 


creation 
4tronix 


This bright light-up face will add character to your projects 


aunched via Kickstarter, 

McRoboFace is a PCB board 

with 17 WS2812B RGB 
LEDs, also known as NeoPixels. 
These are fully addressable and 
arranged in the shape of a face. 
At full power, they’re blindingly 
bright and, while their intensity is 
adjustable via software, we’d advise 
purchasing the optional diffuser 
kit to soften the effect; the frosted 
acrylic diffuser is easily fitted to 
the front using three nylon screws, 
nuts, and spacers. 
Either way, you’1l need to solder 
on the supplied four-pin right- 
angled header to connect it to your 
Raspberry Pi. It can also be driven 
by many other microcontrollers, 
including micro:bit, Arduino, 
Codebug, BeagleBone, Crumble, 
and ESP8266. When using it with 
the Pi, you have two options. The 
first method is to connect it via a 
Picon Zero, using output 5 set to 
WS2812B. Since the Picon Zero 
also features two H-bridge motor 
drivers, it’s an easy way to create 


a wheeled robot with an expressive 
face at the front. 

Alternatively, you can hook 
the McRoboFace up directly to 
the Pi’s GPIO pins 5V and GND, 
along with GPIO 18 (the PWM 
pin) for precision control of the 
NeoPixels. While requiring a few 
extra setup steps, this method 
works perfectly well; no voltage 
level shifting is needed, as the 
pixels can be controlled using 3.3V 
quite happily. Incidentally, the 
fourth McRoboFace pin is a digital 
out for daisy-chaining with other 
NeoPixel displays. 

The Pi connection method 
will determine the Python 
programming method for 
controlling McRoboFace. Again, 
a little more setup is required 
when using the GPIO pins directly, 
including the importing of the 
neopixel (rpi-ws281x) library. It’s 
not a major hurdle, however, as 
you can just adapt the example 
code from the GitHub repo 
(magpi.cc/2dxooY3). 


Controlling the NeoPixels is easy 
enough, as they’re numbered on 
the PCB: 15 and 16 for the eyes, 

14 for the nose, and the rest for 
the mouth. Since they’re all fully 
addressable, you can adjust the 
RGB shade and brightness of each 
precisely. This makes it possible 
to create some very impressive 
fade and colour cycle effects. 
Using Python lists also enables 
you to easily change several pixels 
at once for facial expressions. 


{ast word 


McRoboFace is an inexpensive 
and fun way to add a bit of 
character to your robots or 
other creations with facial 
expressions, or as a general 


NeoPixel light display. You 
could even hook it up to an 
audio input, as Robin Newman 
did (magpi.cc/2dxqZ4k), 

to ‘sing’ along to music! 
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Maker 
says 
An 

easy-to-use 
8-character 
7-segment 

display add- 


on board 
Average Man 


MICRO DOT 
PHAT 


Able to display 
text and 
numbers, this 
LED matrix 
display is 

very versatile 
and renders 
characters in 
great detail. 


£22 / $27 
magpi.cc/2cfq70b 


ZEROSEG 


ZEROSEG 


Build your own old-school red LED display 


hile playing around with 

some generic spare parts, 

including a standard 
seven-segment LED unit, Richard 
Saville - aka Average Man vs Pi 
(averagemanvsraspberrypi.com) 
- had the idea of creating a more 
polished, Pi Zero-sized display. 
Following a lot of reverse- 
engineering, trial and error, and 
prototyping, he came up with the 
ZeroSeg, which features two four- 
digit display units. 

The first thing to note is that it 

comes in kit form, with numerous 
components to solder onto the 
rear and front of the small board 
including various resistors and 
capacitors. Fortunately, there’s an 
excellent online assembly guide 
to help you, as the parts need to 
be added in a specific order. Quite 
a bit of precision is required, too. 
For instance, the MAX7219CNG 
chip socket must be flush with the 
board edge to enable you to cram in 
the two LED units; when soldering 


) 
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the latter, you also need to take 
care not to touch previously added 
components on the rear. Still, 
it’s fun to put together and you 
get a sense of achievement when 
it’s completed. 
To get it working, you need to 
install the ZeroSeg Python library 
and spidev, and enable the SPI 
interface on the Raspberry Pi. In 
addition to power and ground, it 
only uses five GPIO pins: 8, 10, 11, 
17, and 26; this means there are 
still plenty to play with if you’ re 
breaking them out or stacking the 
ZeroSeg on top of another board. 
The ZeroSeg code library includes 
a few Python examples to get 
you started, including a demo 
that shows off its capabilities, 
such as the ability to fade the 
brightness through 15 levels and 
scroll digits across the display. It’s 
fairly easy to program by adapting 
examples, although we couldn’ t 
figure out a way of showing text; 
this may well have been added by 


the time you read this, although 
some letters (such as M and W) 
are impossible to reproduce on 
a seven-segment display. So it’s 
best suited to displaying digits; 
use cases include a temperature 
monitor and time/date display. 
The two programmable mini- 
buttons are a nice bonus and can 
be used to switch what’s shown. 


Jast word 


While not as flexible as a 
matrix display, the ZeroSeg 

is great for value for money 
and fun to assemble. More 
suited to displaying digits than 
text, it's fine for numerical 


data, which may be scrolled 
across the two LED units. The 
latter are bright enough at full 
power, although in daylight 
the white non-lit sectors are 
very visible. 
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ANKER 
ASTRO E1 
5200MAH 


You can power 
a Raspberry Pi 
using most USB 
battery packs 
designed for 
smartphones. 
These are 
bulkier and less 
integrated than 
the Zero LiPo. 


£12 / $16 
magpi.cc/2d21wiE 
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Maker 
says 
Aims 

to give you 

the most 

compact 

Raspberry Pi 

power supply 


possible 
Pimoroni 


ZERO LIPO 


Reliable and portable power for the Raspberry Pi 


he Zero LiPo is a tiny 

add-on board for the 

Raspberry Pi that enables 
you to power it from lithium 
polymer and lithium ion batteries. 

The board itself is tiny. 
Measuring just 0.8mm thick 
and weighing 2.9g, it doesn't 
interfere with your usage of the 
Raspberry Pi. 

It attaches to the eight GPIO 
pins at the top of the pin layout 
(covering the two 5V pins, 3.3V, 
GPIO 3 and 4, and Ground). From 
here it provides power to the 
Raspberry Pi, while leaving the 
micro-USB power socket free. 

There are two ways to attach 
the Zero LiPo to the Raspberry Pi. 
You can either solder the board to 
the bottom of the standard GPIO 
header, or you can solder it toa 2x4 
female header. 

This second option enables you 
to attach, and remove, the Zero 


LiPo to/from the GPIO pins, but 
it blocks the pins. Both options 
require deft soldering skills. 

In addition to the Pi Zero, you 
can use the Zero LiPo on any 
Raspberry Pi model. 

Once attached to the Raspberry 
Pi, the board gets its power from 
a battery via a JST connector. Just 
charge up your battery, then plug it 
in to power up the Raspberry Pi. 

Pimoroni is selling a range of 
LiPo and Li-ion batteries, ranging 
from £4.50 to £18. 

We tested a1200mAh LiPo and 
a 2200mAh Li-ion battery. Both 
battery types function largely the 
same (plug and go). The board 
uses a step-up boost converter 
(TPS61232) to convert the 3-4.2V 
from the batteries to the 5V used 
by the Raspberry Pi. 

As the battery runs out, you get 
an alert at 3.4V: a red low voltage 
warning LED comes on. The board 


automatically shuts down at 3.0V. 
This protects the battery. 

The Pimoroni blog 
(magpi.cc/2d1YwCm) has detailed 
tests on how much usage you 
can expect to get in a variety of 
common tasks, across the range 
of batteries. 

n addition to the Pi Zero, you 
will need a JST charger for your 
battery, such as the Adafruit 
Micro Lipo (£7.50) or PowerBoost 
1000 (£20.50), both also available 
from Pimoroni. 


{ast word 


It's a slick piece of kit, but 
make sure you factor in the 
price of the charger and 


batteries. It's a great option 
for providing safe power for 
a portable project, though. 
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RASPBERRY PI 
BESTSELLERS 


Maker Media's family-oriented series 
puts electronics and fun into learning 
and playing 


FAMILY PROJECTS FOR 
SMART BESS oo 


Author: John Keefe 
Publisher: Maker Media projects 
Price: £14.50 art part ODI 


ISBN: 978-1680451238 


lbs 
magpi.cc/2evoL2V | 


AJ 


Sensors, communication, and 
the whole Internet of Things 
encapsulated in simple and 
fun projects you can do with 
your children. Code is provided, 
so even beginners can try the 
projects out. 


MAKE IT GLOW: LED PROJECTS 
FOR THE WHOLE e 


Authors: Emily Coker, Kelli Townley _ 
Publisher: Maker Media 

Price: £14.50 

ISBN: 978-1680451054 
magpi.cc/2evogdC 


A lovingly presented collection 
of craft-meets-electronics 
that will enthral and enthuse 
your mini-makers. Projects 
include firefly nightlights, 
light-up tote bags, fairy wings, 
thunderclouds, a superhero 
cape, and more. 


MAKE: TECH DIY: EASY 
ELECTRONICS PROJECTS FOR 
PARENTS AND KIDS  — 


Authors: Ji Sun Lee, Jaymes Dec g 
Publisher: Maker Media 
Price: £14.50 

ISBN: 978-1680451771 
magpi.cc/2evspJS 


Felt, paper, and card meet 
LEDs, resistors, and the 
good old 555 timer chip, in 
a collection of projects kids 
will enjoy making and using 
- without realising they're 
learning, too. 
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YOCTO FO 
RASPBERRY PI 


Author: Pierre-Jean 
Texier, Petter Mabacker 
Publisher: Packt 

Price: £23.99 

ISBN: 978-1785281952 
magpi.cc/2evoD38 


The Yocto Project is 
a build system for products 
on embedded devices - popular 
boards like BeagleBoard and the 
Raspberry Pi - and the Pi’s extra 
grunt makes it an ideal platform 
for developing and trialling Yocto 
builds of embedded apps, ina 
more realistic environment than 
running inside QEMU on your PC. 
A complex collection of 
tools, processes, templates, 
and methods, getting started 
with Yocto is greatly aided bya 
well-ordered guide. Texier and 
Mabacker provide a step-through 
guide to working with BitBake, 


BUILDING A VIRTUAL 
ASSISTANT FOR 


RASPBERRY PI 


Author: Tany Pant 
Publisher: Apress 
Price: £14.99 

ISBN: 978-1484221662 
magpi.cc/2evszRu 


From Siri to Tony 
Stark’s Jarvis, 
everyone is speaking 
to virtual assistants, but how about 
creating your own? Tanay Pant’s 
concise guide does just that and, 
despite the slightly grating (but 
presumably postmodern ironic) 
aspect of the female-voiced 
assistant greeting those who 
follow the project with a 1960s 
assistant-style “Hi, handsome”, 
bear with it as the project is 
well put together and actually 
quite useful. 

A virtual assistant is made up 
of speech-to-text (STT), logic, 
and text-to-speech (TTS). STT is 


Yocto for Raspberry Pi 


OpenEmbedded-Core, Poky, BSP 
(the meta-raspberrypi layer), 
introducing Yocto workflow, 
building your first system 
with Poky, and the BSP layer 
for Raspberry Pi. These layers 
are assembled as recipes, then 
put through BitBake to build 
the image for the Pi’s SD card. 
After working through 
BitBake’s powerful features, 
the authors look at Raspberry 
Pi-specific aspects of 
developing with Yocto, and 
introduce a project to work with 
the Pi’s GPIO pins. The provided 
code is in C, but shouldn’t be too 
much of a stretch for anyone with 
programming basics. Further 
Yocto layers follow, built of 
collections of recipes, for better 
organisation of larger projects. A 
home automation project brings 
together everything learned. 


Score 


farmed out to Google’s powerful 
service, but other options are 
considered, and you can substitute 
in one of them. TTS is provided 
by the eSpeak package, and some 
basic code soon gets the reader 
in ‘conversation’ with the Pi 
(once you’ve acquired a USB 
microphone for it!). The rest 
of the book builds the logic 
layer to add to the assistant’s 
accomplishments. 
All code is in Python, anda 
lot of conversation depends 
on if-elif-else statements. Siri- 
style look-ups of definitions 
from Wikipedia, or the day’s 
weather or business news, form 
the basics, but adding Selenium 
testing of your website(s) opens 
the reader’s eyes to other 
possibilities. A music player, 
note taker, and Twitter interface 
are followed by suggestions for 
further development. 


Score 
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MACHINE LEARNING 
FOR DUMMIE 


Author: John Paul Mueller, 
Luca Massaron 

Publisher: Wiley 

Price: £21.99 

ISBN: 978-1119245513 
magpi.cc/2evs364 


A brave move ina 
beginner’s book 
is to make the reader learn two 
languages — R and Python - but 
R has great strengths in dealing 
with statistics, and Python is the 
best general-purpose language for 
machine learning. It’s all about the 
data, and the language intros get 
straight to work on manipulating 
mathematical matrices, lists, and 
multiple-dimensional arrays. 
Unlike many ‘... for Dummies’ 
series books, this one seems aimed 
more at traditional learners, with 
fewer space-filling diagrams, and 
far more instructive text. To give 
a rounded picture of machine 


THE NEO- 
GENERALIST 


Author: Kenneth Mikkelsen, 


Richard Martin 
Publisher: LID THE 
Price: £12.99 (O-GENERALIST 


ISBN: 978-1910649558 
magpi.cc/2evq7KV 


While the US 
Department of Labor 
states that two-thirds 
of children in primary schools 
today will work in jobs that have 
not yet been invented, many of u 
have been making up careers as 
we go along for a long time. The 
rhyme ‘Jack of all trades / Master 
of none’ was completed in the 
original Elizabethan form with 
‘Oft’ times better / than a master 
of one.’ 

The Neo-Generalist takes in 
all who switch from generalist 
to hyper-specialist: the multi- 
hyphenate, portfolio or slash 
career; full stack engineers; 


n 
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learning — a vast topic — the 
book jumps between practical 
and informational sections, and 
some readers may find 
themselves skipping back 
and forth among sections 
to get the most out of it. 
And what a lot there is 
to get out of this one: the 
future of machine learning; 
language intros; maths 
and statistics (all of that 
high school learning you’ve 
forgotten); a great introduction 
to many of the algorithms you 
need to know, working examples 
in Rand Python to illustrate 
what you’ve learned; and a great 
selection of machine learning 
problems tackled using the skills 
you’ve been learning, followed by 
a look at where to explore next. 
Comprehensive, and not just 
for dummies. 


Score 


tinkerers; inventive dilettantes 
who are a familiar feature at 
makerspaces and at Python 
conferences where, for example, 
a surprising percentage of 
coders have a background 
as professional musicians; 
and those who follow a 
‘continuum of options’. 
The authors’ sweeping 
style — reminiscent of 
Leslie Kenton - won’t be 
to all tastes, but they’ve 
done a magnificent job of 
showing multiple possibilities 
that exist for creative people in 
our changing times, illustrated 
with dozens of interviewees from 
many walks of life, and frequent 
crossings between disruptive 
technology, the arts, and social 
enterprise. If you find yourself 
‘living in more than one world’, 
take heart: you’re certainly 
not alone. 


Score 


ESSENTIAL READING: 


GNU EMACS 


Get to grips with the programmer's editor that 
thinks it’s an operating system 


Harley Hahn's Emacs Field Guide 


Author: Harley Hahn 
Publisher: Apress 
Price: £19.99 

ISBN: 978-1484217023 
magpi.cc/2evrRUz 


The veteran tech author brings his 
beginner-friendly style to introducing 
Emacs. Abounds with history, geekiness, 
and clear explanations. 


Emacs 


Author: N/A 
Publisher: GNU 
Price: N/A 

ISBN: N/A 
magpi.cc/2evq6qd 


Emacs is a self-documenting editor with 
built-in tutorial. So, Ctrl-h a searches for 
the appropriate Emacs info page. 


Mastering Emacs: 2nd Edition 


Author: Mickey Petersen 


MASTERING | 


Publisher: ebook - masteringemacs.org 
Price: $39.99 l 
ISBN: N/A EMACS | 


magpi.cc/2evrhGi 
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eN WICKET PETERSEN 
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Philosophical and practical guide to 
the ultimate ‘tinkerer’s editor’, updated 

for Emacs 25. Thoughtful, immersive, Ss 
and full of useful workflow tips. 


Sa aS 


Sacha Chua's Emacs blog 


Author: Sacha Chua 

Jim Mlodgenski & Kirk Roybal 
Publisher: N/A - blog 

Price: N/A 

ISBN: N/A 
magpi.cc/2evsOvW 


Rivalling (or surpassing!) the EmacsWiki, 
from an A3 poster introducing Emacs to 
beginners, to detailed modifications of 
numerous modes. 


The Org Mode 8 Reference Manual 


Author: Carsten Dominik 
Publisher: Samurai Media 
Price: £16.03 

ISBN: 978-9881327703 
orgmode.org 


The Org Mode 8 
Reference Manual 


Written by Org Mode's original author. 
Organise your projects, your business, 
and your life, with Emacs’ secret weapon. 
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THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


MA 


NEW 
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ne of the biggest events on the maker calendar 

is the World Maker Faire in New York, and it’s 

a bit of a tradition with the Raspberry Pi team; 
before the computer came out in 2012, the Raspberry Pi 
was being demonstrated by (the very small) team Pi. 

Things have changed a lot since then and Raspberry 

Pi was a prominent presence at this year’s event, with 
members from the Foundation and Trading company 
attending to help out. This included The MagPi’s Lorna 
Lynch, who has blogged about the experience in detail 
on the Raspberry Pi blog (magpi.cc/2emXdBX). 


RASPBERRY PI LIVE! 


Feel like you missed out by not going 
to see Raspberry Pi in New York? The 
team recorded a live video tour of 
the Pi booth and surrounding areas at 


magpi.cc/2ejpaoK 


the Maker Faire, which you can watch 
on the Raspberry Pi Facebook page 

by following the shortlink. It might 

be a good idea to get the page liked 

if you want to be ready for the next 
livestream: facebook.com/raspberrypi 
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A handy sign 
pointing you in the 
right directions at 
Maker Faire 


“As in previous years, there were many excellent 
Raspberry Pi-based projects, as well as familiar faces 
from the Pi community. There was an excellent display 
of Pi-controlled Lego Mindstorms robots. We also 
met the guys from Pi Supply showcasing their new 
JustBoom equipment, bringing affordable high-quality 
audio to Raspberry Pi users. Eager experimenters of all 
ages came to try out our Sense HAT activities, and to 
tell us about the Pi projects they had made at home. 
One man was even wearing a Pi Zero as a necklace!” 

It looks like it was a lot of fun; we hope to see you 
there next year, or maybe even at the Bay Area Maker 
Faire in May! 


It tipped down with rain during 
setup the day before, but that 
didn't stop our brave volunteers 


raspberrypi.org/magpi 


THIS MONTH IN PI 


Community 


CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


ip a 


SPY V. SPI 
unn 


A lot of Raspberry Pi robot kits you can buy have an 
educational slant, teaching you code and/or robotics 
as you create and program your robot. Spy v. sPi 
takes this educational angle in a different direction, 
with the robots being built and programmed to fulfil 
missions in what Dexter Industries are calling a 
‘capture-the-flag adventure’. This is done by using 
sensors to protect or capture an electronic treasure 
the teams are vying for. It sounds like a lot of fun, 
and with your help they can get it out. 


SPIRIT ROVER 


This campaign will have finished by the time this goes 
to press. However, it’s hit the goal so expect to see 
more of it soon: it’s another learning robot, but this 
one is based on Mars rovers! It combines Raspberry Pi 
and Arduino for the usual robo-education of building 
and coding. This one is fairly unique, as it has a row of 
awesome NeoPixels on its chassis and just under the 
ultrasonic sensors to make it look like it has a face. 
It’s got a lot of amazing functions, so it’s definitely 
one to keep an eye on. 
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PISHIELD 


kck.st/2dCw8c1 


Here’s something that’s a bit more 
of a utility. The PiShield is a shield 
for the Pi Zero that adds eight 
5V analogue sensor ports and 
four IC device ports to the 

Pi. As its form factor is 
designed for the Pi Zero, 

that means it also fits ® i 
on other Raspberry 3 
Pis, as long as they have 

the 40-pin GPIO. This makes 

it pretty useful for many robot or 
home automation projects, and it’s 

actually already been funded. Just a $20 
(Canadian) pledge guarantees one for yourself. 


WSF DRONE WITH 
A PI CAMERA 


PI CART 
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Matt spends his days creating awesome 
builds for integrated marketing agency 
redpepper in Nashville, Tennessee 


att’s background is in 

web design/development, 

extending to graphic design 
in which he acquired his BFA at the 
University of Tennessee-Knoxville. 
In his youth, his passion focused 
on car stereo systems, designing 
elaborate builds that his wallet 
couldn’t afford. However, this 
enriched his maker skill set by 
introducing woodwork, electronics, 
and fabrication exploration into 
his creations. 


years ago, Matt originally worked 
in the design and production 
of microsites. However, as his 
interests continued to grow, 
demand began to evolve, and 
products such as the Arduino 
and Raspberry Pi came into mix. 
Matt soon found himself moving 
away from the screen toward 
physical builds. 

“Pm interested in anything that 
uses tech in a clever way. Whether 
it be AR, VR, front-end, back-end, 


redpepper ‘Touch of Tech’ 
online series, highlighting 
the latest in interesting and 
unusual tech releases 


app dev, servers, hardware, UI, 
UX, motion graphics, art, science, 


Having joined the integrated 
marketing agency redpepper eight 


Q, 


E; 
> 
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Sniffur allows Matt to keep tabs on his roaming greyhound, 
Bean, using a collar-mounted beacon and three Raspberry Pis 


or human behaviour. I really enjoy 
coming up with ideas people can 
relate to.” 

Matt’s passion is to make tech 
seem cool, creative, empowering, 
and approachable, and his projects 
reflect this. Away from the 
Raspberry Pi, Matt has built some 
amazing creations such as the Home 


Matt continues to bridge the gap 
between the company’s day-to- 
day business and the fun, intuitive 
uses of tech. Not only do they offer 
technological marketing solutions 
via their rpLAB, they have 
continued to grow, incorporating 
Google’s Sprint methodology into 
idea building and brainstorming 


Im interested in anything that 
uses tech in a clever way 


Alone Holidaython, an app that lets 
you recreate the famous curtain 
shadow party in Kevin McCallister’s 
living room. Pick the shadow you 
want to appear, and projectors 
illuminate the design against a 
sheet across the redpepper office 
window. Christmas on Tweet Street 
LIVE! captures hilariously negative 
Christmas-themed tweets from 
Twitter, displaying them across a 
traditional festive painting, while 
DOORS8ELL allows office visitors 
the opportunity to Slack-message 
their required staff member via an 
arcade interface, complete with 
8-bit graphics. There’s also been 
a Capacitive piano built with jelly 
keys, a phone app to simulate the 
destruction of cars as you sit within 
traffic, and a working QR code made 
entirely from Oreos. 

Playing the ‘technology 
advocate’ role at redpepper, 
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within days of receiving a request, 
“so having tools that are powerful, 
flexible, and cost-effective like the 
Pi is invaluable.” 

“I just love the intersection of 
art and science,” Matt explains 
when discussing his passion for 
tech. “Having worked with Linux 
servers for most of my career, the 
Pi was the natural extension for 
my interest in hardware. Running 
Node.js on the Pi has become my 
go-to toolset.” 

We’ve seen Matt’s Raspberry Pi- 
based portfolio grow over the last 
couple of years. A few of his builds 
have been featured in The MagPi, 
and his Raspberry Preserve was 
placed 13th in the Top 50 Raspberry 
Pi Builds in issue 50. 

There’s no denying that Matt 
will continue to be ‘one to watch’ 
in the world of quirky, original 
tech builds. 
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EVENT CALENDAR (Q) Pasie uam 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


Want to add your get-together? 
List it here: 


raspberrypi.org/jam/add 


Want a Raspberry Jam in your 


area? Want to start one? 4 RASPBERRY JAM TOKYO RASPBERRY JAM 
Email Ben Nuttall about it: BOGOTÁ #007 


ben@raspberrypi.org 


HIGHLIGHTED EVENTS 


TOKYO RASPBERRY JAM 
#007 

When: Sunday 6 November 
Where: Hodokubo 2-1-1, Hino, 


REGULAR EVENTS 


RASPBERRY JAM LEEDS 

When: Wednesday 2 November 

Where: Swallow Hill Community 
College, Leeds, UK 


RASPBERRY JAM BOGOTA 

When: Saturday 19 November 

Where: Avenida El Dorado Carrera 
45 # 26 - 33, Bogota, DC, 


Tokyo, Japan 
magpi.cc/2dNUfT6 
The Japanese Raspberry Pi Users 
Group is putting on a Jam for 
Tokyo locals to learn about the Pi. 


2ND WIMBLEDON 

RASPBERRY JAM 

When: Sunday 13 November 

Where: Wimbledon Library, 
Wimbledon, UK 

magpi.cc/2dNW4zu 

Projects and talks from teachers 

and children to help inspire people 

in computing and using the Pi. 
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Colombia 
miraspberrypi.com 
Presentations and workshops at 
the first and longest-running 
Latin Raspberry Jam. 


BALTIMORE 

RASPBERRY JAM 

When: Saturday 3 December 
Where: Digital Harbor Foundation 
Tech Center, Baltimore, MD, USA 
magpi.cc/2dNYFsU 

Dedicate some time to exploring 
the Raspberry Pi or working on 
your own Pi projects. 


magpi.cc/2dNPDfP 

Everyone is invited for a couple 
of hours of computing fun, 
talks, demonstrations, and 
hands-on workshops. 


RASPBERRY JAM 

PRESTON 

When: Monday 7 November 

Where: Media Innovation Studio, 
Preston, UK 

magpi.cc/2dNRpok 

Learn, create, and share the 

potential of the Raspberry Pi 

at a family-friendly event. 
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F RASPBERRY JAM 


R 2 2ND WIMBLEDON 
_ ~~ RASPBERRY JAM 


TORBAY 
TECH JAM 


TORBAY TECH JAM 


When: Sat 


Where: Pai 


urday 12 November 
gnton Library and 


Information Centre, 


Pa 


ignton, UK 


torbaytechjam.org.uk 


A fun, informal, and family-friendly 


event tha 


HULL 


t aims to inspire people to get 


into code and take up STEM subjects. 


RASPBERRY JAM 


When: Sat 


urday 12 November 


Where: Malet Lambert School, 
Hull, UK 


potential 
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magpi.cc/2dNRAJ6 
Bringing people together from across 
a wide area to discover the exciting 


of the Raspberry Pi. 
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JAMS 
EVERYWHERE! 


le LIL, WIN Walle, Gue'S:. 


SCOTLAND NEEDS RASPBERRY JAMS 


Raspberry Jam community 
manager Ben Nuttall would 
like you to help Raspberry 

Pi spread Raspberry Jams 
around the country, and one 
area that could do with more 
is Scotland. If you're handy 
with a Raspberry Pi and know 
others who are, see over the 
page to find to some top tips 
on setting up and getting 
people interest in attending 
a Raspberry Jam near you. 


The Glasgow Raspberry Pi Day was great: 
let's get more Jams in Scotland! 
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INTERVIEW 


BLACKPOOL 
RASPBERRY JAM: 


AN INTERVIEW WITH LES POUNDER 


Practical tips for running a Jam for your local community from the chief, Les Pounder 


ontributor to the magazine 
and Raspberry Jam runner 
Les Pounder talks to us 


about his experiences. 


How did you find out about 
Raspberry Pi? 

“Having used Linux since the late 
1990s, I was always on the lookout 
for new Linux devices. Whilst 
reading the BBC’s technology 
page, I stumbled upon Rory 
Cellan-Jones’s piece introducing a 
new small computer, which at the 
time resembled a USB flash drive. 
I was intrigued and so, along with 
many others, I was online at 6am, 
29 February 2012 and managed to 
secure my first Raspberry Pi.” 


LES POUNDER 


Les Pounder is a maker, author, and hacker 

who lives in the UK. He regularly works with the 
Raspberry Pi Foundation to deliver Picademy 
training to teachers. He also writes a blog at bigl.es 
for some of his crazy ideas. 
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How did you get involved in the 
Raspberry Pi community? 

“Since day one I have been a 
staunch supporter of the Raspberry 
Pi as a platform for social change 
and invention. When I first 
started in the community, I knew 
nothing about programming and 
electronics, but with the help of 
the community and quite a lot of 
rather basic questions, I quickly 
understood what could be done 
with the Raspberry Pi. The main 
service that the community 
provides is support. Without it, 
the Raspberry Pi would just be 
another single-board computer 
vying for the attention of the 
masses. The community embraced 
the Raspberry Pi and created many 
wonderful projects that benefit 
everyone in many different ways. 
Children learn to code, become 
inspired through science and 
engineering thanks to Astro Pi, 
and learn how data can be used to 
shape our lives. The community 
are the backbone that support the 
project, and I would like to say 
thanks to every member of the 
Raspberry Pi community.” 


What was the first Raspberry Jam 
you attended? 

“My first Jam was in Manchester, 
hosted by a fresh-faced Ben 
Nuttall. At this Jam I met many 
like-minded individuals, including 
a rather young Amy Mather who 
has now gone on to great things. 


This Jam was one of the very first 
to exist and, at the time, it was 
testing the water as to howa Jam 
should be organised. There were 
lots of tables full of Raspberry Pis 
being used to play videos using 
XBMC, and children learning to 
make games with Scratch and 
doing basic Python programming.” 


Why did you decide to start the 
Blackpool Raspberry Jam? 
“Blackpool isn’t exactly a tech 
hub. Our transient population 
relies on seasonal work and, as 
such, Blackpool suffers from many 
social issues, of which poverty is 
one. I started Blackpool Raspberry 
Jam as a way to introduce 
computing and creating inventions 
to the children of the area. We 
take the Jam on the road to the 
many libraries of Blackpool and its 
surrounding boroughs. Blackpool 
Libraries have supported our 

Jam since day one and provide a 
free venue inside a local library, 
which means that we don’t have 
to charge our attendees, and this 
enables us to provide free access 
to the Raspberry Pi.” 


How did you go about organising 
the first Blackpool Jam? 

“Once I organised a venue with 
Blackpool Libraries, the rest 

just fell into place. I already had 
plenty of Raspberry Pi computers, 
power supplies, and cables. All I 
needed were keyboards, mice, and 
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screens, which the local library 
was able to make available to us. 
But really, for a Jam all you need 
is a space, some tables, and access 
to power and WiFi. Then invite 
people from your local community 
via posters in community spaces. 
We approached Blackpool Council 
to provide advertising across 
Blackpool at all public libraries 
and museums. Once we had 

the advertisements and venue 
sorted, everything else was easily 
manageable thanks to the great 
team of STEM Ambassadors 

that work with me at Blackpool 
Raspberry Jam.” 


What activities did you put on at 
the Jam? 

“I offered lessons for those new to 
the Raspberry Pi to enjoy. Nothing 
formal, just fun bite-size projects 
that can be completed with very 
little code and in very little time: 
ideal for children with a short 
attention span. Seriously, you can 
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have so much fun using a jelly baby 
as a push-button burp trigger! 

For more advanced attendees, 

we provided space and facilities 

for them to show their projects 

to the group. We’ve seen robots, 
scary spooks that react to sound, 
and many LED projects created by 
children in the local area.” 


How did the Jam go? How many 
people attended? 

“For our first Jam we had around 
20 people turn up, including 
Raspberry Pi co-founder Pete 
Lomas who gave a great talk on 
how the Pi came to life. Each 
month at the Jam we now see 
around 12 people attend, which is 
perfect for the small space that we 
have. What I like about just having 
12 people is that we have parents 
learning with their children, and 
my team and I have the time to talk 
to them and offer advice, ideas, 

and suggestions on all manner of 
Raspberry Pi queries.” 


* LAUNCH 
LIKEAPRO * 


Featuring an SD card preloaded with a custom version of 


01. EXPERIENCE 

Attend a few different Jams in your area and geta 
feel for how each of them is run. Take the best bits 
and use them for your Jam. 


03. PERSEVERANCE 

Don't worry if you don’t attract many people - 
quality of interaction with your attendees will 
create a better Jam than having hundreds of 
people that you never speak to. 


NOOBS along with Raspbian PIXEL and Raspbian Lite operating 
systems, the WD PiDrive Foundation Edition is ready to help 
you explore new worlds in a matter of moments. 


© WDLABS 


wdlabs.wd.com 


LETIERS 


There's a lot that International keys 
comes with the denne : : r A 
kit other than Pve just teceived issue 50, along with an email from 
the keyboard my wife asking if I wanted to renew the subscription. 


I actually told a client I had to call them back so I 
could phone my wife and tell her not to cancel it 
under any circumstances! 
It was great to learn that the Raspberry Pi 
= Foundation are offering an official starter kit as, 
g having bought Pis from the start (actually being 
one of the first people to email them about it before 
the website was even set up), there has often been 
difficulty getting peripherals that work first time. 
( = woos e ; It’s not the case any more, but it was when they first 
came out. 
t: 4 ame) What disappoints me is the keyboard seems to 
à be the standard US layout, and not the UK layout 
we know and love. I know there are only two 
et, differences between the two: the placement of the 
“ and @ symbols. For a developer like me, though, 
es that’s a massive difference between code working 
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Make it happen 

Dear MagPi, 

Congratulations on 50 issues and 10 million 
Pis. I’m happy to see that in your list of the 

50 greatest Raspberry Pi projects of all time, 

no fewer than two were made at Makespace, a 
maker community and space in Cambridge. Both 
Tom Oinn’s mind-bending robot Triangula and 
Brian Corteil’s Digital Zoetrope might never 
have been made without Makespace’s laser 
cutters, electronics equipment, and assorted 
other kit, and above all, its supportive and 
enthusiastic community. 

Around the world, makerspaces are springing 
up and helping to equip and train a whole 
generation of makers, from beginner to expert 
and from children to pensioners. If they are 
anything like Makespace, I expect they’ re all 
hotbeds of Raspberry Pi projects, too. Perhaps we 
might see a feature on them in a future issue? 
Mark Wainwright 


Hi Mark; we’ve heard many wonderful things 
about the Makespace in Cambridge, especially as 
its in the Pi’s home town. We don’t have anything 
to announce just yet, but we definitely have been 
talking about doing some stuff on makerspaces: 
watch this space! 


and having to spend hours going through it to find 
your mistake. 

Can you let us know via the next issue if that’s 
the actual keyboard we will receive, or if UK buyers 
will get the UK version? I buy these for people all 
the time as they’re so inexpensive, so knowing 
I can get a starter kit in a UK layout will tell me 
whether to purchase one for those people or not. 
lan Williams 


Hi Ian; we hope you didn’t get in any trouble with 
your client for having to hang up! As for the layout of 
the official keyboard, it’s the American layout even 
on those bought in the UK for the moment. It’s still 

a lovely little keyboard, and well worth having to 
change your thinking around a bit just to make sure 
you’ re using the right keys. You could also probably 
pick up another keyboard that will work for very little 
money if you absolutely need it! 
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YOUR LETTERS 
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FROM THE FORUM: 


ARTICLE 
DATABASE 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving for the 
community - join in via raspberrypi.org/forums 


ello, 

It would be very useful to have a table of contents for all 

issues (regular issues and all special topic issues) of The 
MagPi which could be searched. 

For example, it would be useful when I would like to find all issues 
of The MagPi which are part of a guide to learn C (which would be 
issues 47, 48, and 49). 

Is something like this already available? If not, would it be 
possible to produce something like this? 

Best regards, 
Supermerlin 


There’s a database available for the first 30 issues of The MagPi 
(magpi.cc/2ds5RbZ) and we have heard of a few people that keep 
their own database of all the articles in each issue. It’s absolutely 
feasible, though, and we’d certainly welcome someone creating 
and maintaining a database for us online, as it would help out the 
editorial team at times. 

If you have a public database of all The MagPi articles, please get 
in touch; we can try to do something to help and make sure it’s got 
a bit more notoriety! 


WRITE TO US 


Have you got something you'd like to say? 


Get in touch via magpi@raspberrypi.org or on The MagPi 
section of the forum at: raspberrypi.org/forums 
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In association with 


pi-top 


www.pl-top.com 


ONE OF TWO 
PI-TOPCEEDS 
OR A PI-TOP! 


PI-TOP IS A DIY LAPTOP AND PI-TOPCEED IS THE ALL-IN-ONE 
DESKTOP, BOTH POWERED BY THE RASPBERRY PI 


The ideal maker devices and learning tools for STEAM education. Both come 


with pi-topOS to easily start coding, building circuits, and making hardware. 


WHICH 
CROWDFUNDING 
SITE DID THE 
ORIGINAL PI-TOP 
LAUNCH ON? 


Tell us by 21 November Simply email competition @raspberrypi.org 
for your chance to win! with your name, address, and answer! 


Terms & Conditions 

Competition closes 21 November 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 
spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Love your Pi? Love Music? 


Designed by audio experts, enjoyed by everyone 


Jaw dropping audio quality for your Raspberry Pi 
It))) Connect Headphones, Speakers, RCA, Toslink, S/PDIF or XLR 


We work with all the major music solutions to ensure compatibility 


©) VoLUMIO (OOP) @Archphile JL +% Koni 


PiMusicBox 


Twitter: @IQ_audio IQaudio Limited, 
Email: info@iqaudio.com | a U d | O Cricklade Wiltshire. 
Web: www.iqaudio.com Company No.: 9461908 


LEARN 


' CODE 
-WITH ` 


PROGRAM WITH THE WORLD'S 
Get started today for MOST POPULAR LANGUAGE 


just £2.99 / $3.99 voa Raspberry Pi 


GET IT ON 


P> Google Play 


Sonic Pi 


ri 


CHAPTER 
: a RE ADVANCED 


O E 
LOW CONTROL 


M The ® From the makers of the 
| official Raspberry Pi magazine 


magpi.cc/learn-c-book 
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Column | THE FINAL WORD 


aking things can change your life. It did 
for me, and I hear the same from others 
all the time. 

After I graduated from university in 2003, I jumped 
immediately into the workforce. I landed in New York 
City’s entertainment industry, which is where Pd 
dreamed of working since I was young. I was excited 
to be a staffer on a major television show, where I 
learned what it takes to produce a weekly television 
drama. I slowly worked my way up the ladder in the 
television industry over a few years. 

There’s a lot to admire about how film and 
television content is produced. A crew of over one 
hundred people with creative and technical talents 
come together to create a piece of entertainment, 
under the watchful eye of the director. It’s an 
enormous piece of creative collaboration, but 
it’s also a business. Everyone does their part to 
make it happen. It’s incredible to see a television 
show get made. 

I had found a niche in the television industry that 
I did well in, but eventually I hit a rut. I had a small 
role in a big piece of work. I wanted to be more 
creative, and have more autonomy and influence over 
what I was helping to create. It was at that time that I 
started closely following what makers were doing. 

Feeling inspired by the work of others, I started to 
make things with microcontrollers and electronics. 
Pd then share how to do these projects online. 
Eventually, I was contributing projects to Make: 
magazine and I was soon able to make side money 
from making things for companies, writing about 
how to make, and writing about what others were 
making. Soon enough, I was finding enough jobs 
to leave the television industry and work asa 
maker full-time. 
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MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


| Matt Richardson tells his story of going from hobbyist to career maker 


That eventually led to my current job, doing 
outreach for Raspberry Pi in the United States. It’s 
incredibly gratifying work and despite the long road 
to get there, I couldn’t be happier with what Pm 
doing. The spare time I invested in making things as 
a hobby has paid off greatly in a new career that gives 
me creative freedom and a much more interesting 
work day. 


Make it happen 

I meet people all the time who have stories about 
how making has had an impact on their lives. At 
World Maker Faire New York recently, I met student 
Gerald Burkett; he told me his story of becoming 

a maker. He said, “I’m doing things I wouldn’t 

have ever dreamed of just four years ago, and it’s 
changed my life for the better.” And Gerald is 
having an impact on others as well. Even though 
he’s soon graduating, he’s encouraging the school’s 
administration to foster makers among students. 
He says that they “deserve an inviting environment 
where creativity is encouraged, and access to tools 
and supplies they couldn’t obtain otherwise in order 
to prototype and invent.” 

Because of more accessible technology like 
Raspberry Pi and freely available online resources, 
it’s easier than ever to make the things that you want 
to see in the world. Whether you’re a student or are 
far down a particular career path, it’s also easier than 
ever to explore making as a passion and potentially 
also a livelihood. 

If you’re reading this and you feel like you’re stuck 
in a rut with your job, I understand that feeling and 
encourage you to pursue making with vigour. There’s 
a good chance that what you make can change your 
life. It worked for me. 
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mindsensors.com 


Think @ Create @ Learn @ Educate 


PISTORMS-V 2 


Make Stunning Robots with 
LEGOs and Raspberry Pi ! 


ROBOT 
CHASSIS 


B COMPONENTS RANGE 


The perfect 
companion for 
the SB Components’ 
Motor-Shield 


í 


LEARN | CODE | MAKE 


ONLY £4/$6 
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| official Raspberry Pi magazine DIGITALLY: > Google Play 


98 | MägPi November 2016 raspberrypi.org/magpi 


serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout PI Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential Pi 


8 channel 18 bit analogue to digital 
converter. 1°C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. 1°C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RTC Pi Plus 


Real-time clock with battery backup 
and 5V I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 


1-Wire® to 1°C host interface with ESD 
protection diode and I?C address 
selection. 


electronics 


AISO 
available 
for the 
Pi Zero 


SPY vs. SPI 


CODE. CAPTURE. DEFEND. 


Spy vs. sPi is a capture-the-flag style engineering 
adventure that puts real purpose to basic design and 
programming skills. It can be played individually or in 
teams and is based on the GrovePi. 


Each “spy” is assigned a series of missions, requiring 


them to write code to control an assortment of ge = < 
sensors that will allow them to protect their “jewel” —— a 3 
in different ways, or capture the “jewel” of a ——— ao > 


competing spy. ~ = 
a 
Back us on Kickstarter Sept. 20-Oct 31, 2016! G r O V 2 2 | 
www.dexterindustries.com/spy 
Build your own spy device, saul 


BrickPi 


\ Raspberry Pi + LEGO MINDSTORMS 


el = + 


